Sdílet prostřednictvím

Update-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

Zkontroluje aktualizovaný konfigurační server vyžádané replikace a použije ho.

Syntaxe

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>]

Description

Rutina Update-DscConfiguration se připojí k serveru vyžádané replikace, stáhne konfiguraci, pokud se liší od aktuálního stavu v uzlu, a pak použije konfiguraci na počítač.

Tato rutina je dostupná pouze v rámci kumulativní aktualizace listopad 2014 pro Windows RT 8.1, Windows 8.1 a Windows Server 2012 R2.

Příklady

Příklad 1: Aktualizace konfigurace

Update-DscConfiguration -Wait -Verbose

Po spuštění tohoto příkazu se server připojí k registrované službě vyžádané replikace, stáhne nejnovější přiřazenou konfiguraci a pak ji použije. Parametry Wait a Podrobné jsou volitelné. Při interaktivní práci umožňují tyto parametry při použití konfigurace zpětnou vazbu v reálném čase o průběhu a úspěchu nebo selhání.

Příklad 2: Aktualizace konfigurace připojením přes relaci CIM

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

První příkaz vytvoří relaci CIM pomocí rutiny New-CimSession a pak uloží objekt CimSession do proměnné $Session. Příkaz vás vyzve k zadání hesla. Další informace potřebujete zadáním Get-Help New-CimSession.

Druhý příkaz aktualizuje počítač zadaný v CimSession uložen v $Session. Příkaz určuje parametr Wait. Konzola nepřijímá další příkazy, dokud se aktuální příkaz nedokončí.

Parametry

-CimSession

Spustí rutinu ve vzdálené relaci nebo ve vzdáleném počítači. Zadejte název počítače nebo objekt relace, například výstup rutiny New-CimSession nebo Get-CimSes sion. Výchozí hodnota je aktuální relace na místním počítači.

Typ:CimSession[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

Určuje pole názvů počítačů. Rutina použije nastavení konfigurace na počítače, které tento parametr určuje.

Typ:String[]
Aliasy:CN, ServerName
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje uživatelské jméno a heslo, jako PSCredential objekt, pro cílový počítač. K získání objektu PSCredential použijte rutinu Get-Credential. Další informace potřebujete zadáním Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobName

Určuje popisný název úlohy. Pokud zadáte tento parametr, rutina se spustí jako úloha a vrátí Job objekt.

Windows PowerShell ve výchozím nastavení přiřadí název JobN, kde N je celé číslo.

Pokud zadáte parametr Wait, nezadávejte tento parametr.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ThrottleLimit

Určuje maximální počet souběžných operací, které lze navázat pro spuštění rutiny. Pokud tento parametr vynecháte nebo zadáte hodnotu 0, windows PowerShell vypočítá optimální limit omezení pro rutinu na základě počtu rutin CIM spuštěných v počítači. Omezení se vztahuje pouze na aktuální rutinu, ne na relaci nebo na počítač.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Wait

Označuje, že rutina blokuje konzolu, dokud nedokončí všechny úlohy konfigurace.

Pokud zadáte tento parametr, nezadávejte parametr JobName.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False