Stop-DscConfiguration

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Zatrzymuje uruchomione zadanie konfiguracji.

Składnia

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie Stop-DscConfiguration cmdlet 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 uruchomiono zadania konfiguracji, to polecenie cmdlet zwróci komunikat ostrzegawczy.

Stop-DscConfigurationJest dostępny tylko w ramach pakietu zbiorczego aktualizacji z listopada 2014 r. dla Windows RT 8.1, Windows 8.1 i Windows Server 2012 R2 z biblioteki pomoc techniczna firmy Microsoft. Przed użyciem tego polecenia cmdlet zapoznaj się z informacjami w temacie Co nowego w programie Windows PowerShell 5.0

Przykłady

Przykład 1. Zatrzymywanie zadania konfiguracji

W tym przykładzie sesja ciągłej integracji jest tworzona New-CimSession przy użyciu polecenia cmdlet . 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 , aby określić komputer 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 programie w celu zatrzymania zadania 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 do 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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Stop-DscConfiguration Nie obsługuje parametru Confirm . Jeśli parametr Confirm jest używany, zostanie wyświetlony błąd.

W przypadku poleceń cmdlet programu PowerShell, które obsługują polecenie Potwierdź, użycie parametru wyświetla monit o weryfikację przed uruchomieniem polecenia.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 modelu CIM uruchomionych na komputerze. Limit ograniczania dotyczy tylko bieżącego polecenia cmdlet, a nie sesji lub komputera.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Dane wyjściowe

None