Stop-DscConfiguration
Zatrzymuje uruchomione zadanie konfiguracji.
Składnia
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Opis
Polecenie cmdlet Stop-DscConfiguration zatrzymuje uruchomione zadanie konfiguracji. Określ komputery, których dotyczy to polecenie cmdlet przy użyciu sesji modelu wspólnych informacji (CIM). Jeśli nie ma uruchomionego zadania konfiguracji, to polecenie cmdlet zwróci komunikat ostrzegawczy.
Stop-DscConfiguration jest dostępna tylko w ramach pakietu zbiorczego aktualizacji z listopada 2014 r. dla systemów Windows RT 8.1, Windows 8.1 i Windows Server 2012 R2 z biblioteki pomocy technicznej firmy Microsoft. Przed użyciem tego polecenia cmdlet zapoznaj się z informacjami w Co nowego w programie Windows PowerShell 5.0
Przykłady
Przykład 1. Zatrzymywanie zadania konfiguracji
W tym przykładzie sesja modelu ciM jest tworzona przy użyciu polecenia cmdlet New-CimSession. Obiekt CimSession służy do zatrzymywania uruchomionego zadania konfiguracji.
$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session
New-CimSession używa parametru ComputerName do określenia komputera Server01. Parametr Credential określa konto użytkownika. Obiekt CimSession jest przechowywany w zmiennej $Session. Po uruchomieniu polecenia zostanie wyświetlony monit o podanie hasła konta użytkownika.
Stop-DscConfiguration używa parametru cimSession i obiektu przechowywanego w $Session, aby zatrzymać zadanie konfiguracji.
Parametry
-AsJob
Wskazuje, że to polecenie cmdlet uruchamia polecenie jako zadanie w tle. Aby uzyskać więcej informacji na temat zadań w tle programu PowerShell, zobacz about_Jobs i about_Remote_Jobs.
Aby użyć parametru AsJob, należy skonfigurować komputery lokalne i zdalne na potrzeby komunikacji zdalnej. W systemie Windows Vista i nowszych wersjach systemu operacyjnego Windows należy otworzyć program PowerShell z opcją Uruchom jako administrator. Aby uzyskać więcej informacji, zobacz about_Remote_Requirements.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-CimSession
Uruchamia polecenie cmdlet w sesji zdalnej lub na komputerze zdalnym. Wprowadź nazwę komputera lub obiekt sesji, taki jak dane wyjściowe z New-CimSession lub Get-CimSession.
| Typ: | CimSession[] |
| Aliasy: | Session |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Stop-DscConfiguration nie obsługuje parametru Confirm. Jeśli zostanie użyty parametr Potwierdź, zostanie wyświetlony błąd.
W przypadku poleceń cmdlet programu PowerShell, które obsługują Potwierdź, użyj parametru monitu o weryfikację przed uruchomieniem polecenia.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ThrottleLimit
Określa maksymalną liczbę współbieżnych operacji, które można ustanowić w celu uruchomienia polecenia cmdlet.
Jeśli ten parametr zostanie pominięty lub zostanie wprowadzona wartość 0, program PowerShell oblicza optymalny limit ograniczania na podstawie liczby poleceń cmdlet CIM uruchomionych na komputerze. Limit ograniczania dotyczy tylko bieżącego polecenia cmdlet, a nie sesji lub komputera.
| Typ: | Int32 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
None
Dane wyjściowe
None
