Share via

Update-DscConfiguration

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Sprawdza serwer ściągania pod kątem zaktualizowanej konfiguracji i stosuje ją.

Składnia

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie Update-DscConfiguration cmdlet łączy się z serwerem ściągania, pobiera konfigurację, jeśli różni się od bieżącej w węźle, a następnie stosuje konfigurację do komputera.

To polecenie cmdlet jest dostępne tylko w ramach pakietu zbiorczego aktualizacji z listopada 2014 r. dla Windows RT 8.1, Windows 8.1 i Windows Server 2012 R2.

Przykłady

Przykład 1. Aktualizowanie konfiguracji

Update-DscConfiguration -Wait -Verbose

Po uruchomieniu tego polecenia serwer połączy się z zarejestrowaną usługą ściągania, pobierze najnowszą przypisaną konfigurację, a następnie zastosuje ją. Parametry Wait i Verbose są opcjonalne. Podczas interaktywnej pracy te parametry połączone umożliwiają przesyłanie opinii w czasie rzeczywistym o postępie i powodzeniu lub niepowodzeniu podczas stosowania konfiguracji.

Przykład 2: Aktualizowanie konfiguracji przez nawiązanie połączenia za pośrednictwem sesji ciągłej integracji

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Update-DscConfiguration -CimSession $Session -Wait

Pierwsze polecenie tworzy sesję CIM przy użyciu New-CimSession polecenia cmdlet , a następnie zapisuje obiekt CimSession w zmiennej $Session . Polecenie wyświetla monit o podanie hasła. Aby uzyskać więcej informacji, wpisz polecenie Get-Help New-CimSession.

Drugie polecenie aktualizuje komputer określony w elemencie CimSession przechowywanym w elemencie $Session. Polecenie określa parametr Wait . Konsola nie akceptuje dodatkowych poleceń do momentu zakończenia bieżącego polecenia.

Parametry

-CimSession

Uruchamia polecenie cmdlet w sesji zdalnej lub na komputerze zdalnym. Wprowadź nazwę komputera lub obiekt sesji, taki jak dane wyjściowe polecenia cmdlet New-CimSession lub Get-CimSession . Wartość domyślna to bieżąca sesja na komputerze lokalnym.

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

-ComputerName

Określa tablicę nazw komputerów. Polecenie cmdlet stosuje ustawienia konfiguracji do komputerów, które określa ten parametr.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

Określa nazwę użytkownika i hasło jako obiekt PSCredential dla komputera docelowego. Aby uzyskać obiekt PSCredential , użyj Get-Credential polecenia cmdlet . Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Credential.

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

-JobName

Określa przyjazną nazwę zadania. Jeśli określisz ten parametr, polecenie cmdlet zostanie uruchomione jako zadanie i zwróci obiekt Zadania .

Domyślnie Windows PowerShell przypisuje nazwę JobN, gdzie N jest liczbą całkowitą.

Jeśli określisz parametr Wait , nie określ tego parametru.

Type:String
Position:Named
Default value:None
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, Windows PowerShell oblicza optymalny limit ograniczania dla polecenia cmdlet na podstawie liczby poleceń cmdlet 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

-Wait

Wskazuje, że polecenie cmdlet blokuje konsolę do momentu zakończenia wszystkich zadań konfiguracji.

Jeśli określisz ten parametr, nie określ parametru JobName .

Type:SwitchParameter
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 zostało uruchomione.

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