Udostępnij za pośrednictwem

Update-DscConfiguration

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

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

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 cmdlet Update-DscConfiguration łączy się z serwerem ściągania, pobiera konfigurację, jeśli różni się ona od bieżącego 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 systemu 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 modelu ciM

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

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

Drugie polecenie aktualizuje komputer określony w CimSession przechowywany w $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.

Typ:CimSession[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ComputerName

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

Typ:String[]
Aliasy:CN, ServerName
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

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

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobName

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

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

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

Typ:String
Position:Named
Domyślna wartość:None
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 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.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
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