Update-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

Zkontroluje server vyžádané replikace aktualizované konfigurace a použije ji.

Syntax

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í konfigurace na uzlu, a pak tuto konfiguraci použije na počítač.

Tato rutina je dostupná jenom jako součást kumulativní aktualizace z listopadu 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 Verbose jsou volitelné. Při interaktivní práci umožňují kombinace těchto parametrů zpětnou vazbu v reálném čase o průběhu a úspěchu nebo selhání při použití konfigurace.

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 $Session proměnné . Příkaz vás vyzve k zadání hesla. Další informace zobrazíte zadáním Get-Help New-CimSession.

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

Parametry

-CimSession

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

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

-ComputerName

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

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

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

-JobName

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

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

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

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

-ThrottleLimit

Určuje maximální počet souběžných operací, které je možné vytvořit pro spuštění rutiny. Pokud je tento parametr vynechán nebo je zadána hodnota 0 , vypočítá Windows PowerShell 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, nikoli na relaci nebo na počítač.

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

-Wait

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

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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