Update-DscConfiguration
Zkontroluje aktualizovaný konfigurační server vyžádané replikace a použije ho.
Syntaxe
ComputerNameSet (Výchozí)
Update-DscConfiguration
[[-ComputerName] <String[]>]
[-Wait]
[-JobName <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Update-DscConfiguration
-CimSession <CimSession[]>
[-Wait]
[-JobName <String>]
[-ThrottleLimit <Int32>]
[-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. Pro více informací zadejte 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.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
CimSessionSet
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ComputerName
Určuje pole názvů počítačů. Rutina použije nastavení konfigurace na počítače, které tento parametr určuje.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Čína, Název serveru |
Sady parametrů
ComputerNameSet
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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. Pro více informací zadejte Get-Help Get-Credential.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerNameSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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č.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Wait
Označuje, že rutina blokuje konzolu, dokud nedokončí všechny úlohy konfigurace.
Pokud zadáte tento parametr, nezadávejte parametr JobName.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
