Delen via

Update-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

Controleert de pull-server op een bijgewerkte configuratie en past deze toe.

Syntaxis

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

De Update-DscConfiguration cmdlet maakt verbinding met een pull-server, downloadt de configuratie als deze verschilt van wat er op het knooppunt staat en past de configuratie vervolgens toe op de computer.

Deze cmdlet is alleen beschikbaar als onderdeel van het updatepakket van november 2014 voor Windows RT 8.1, Windows 8.1 en Windows Server 2012 R2.

Voorbeelden

Voorbeeld 1: Een configuratie bijwerken

Update-DscConfiguration -Wait -Verbose

Nadat u deze opdracht hebt uitgevoerd, maakt de server verbinding met de geregistreerde pull-service, downloadt u de meest recente toegewezen configuratie en past u deze toe. De Wait en Uitgebreide parameters zijn optioneel. Wanneer u interactief werkt, zorgen deze parameters voor realtime feedback over voortgang en succes of mislukking bij het toepassen van de configuratie.

Voorbeeld 2: Een configuratie bijwerken door verbinding te maken via een CIM-sessie

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

Met de eerste opdracht maakt u een CIM-sessie met behulp van de cmdlet New-CimSession en slaat u vervolgens het CimSession--object op in de variabele $Session. De opdracht vraagt u om een wachtwoord. Typ Get-Help New-CimSessionvoor meer informatie.

Met de tweede opdracht wordt de computer bijgewerkt die is opgegeven in de CimSession opgeslagen in $Session. Met de opdracht geeft u de parameter Wait. De console accepteert geen extra opdrachten totdat de huidige opdracht is voltooid.

Parameters

-CimSession

De cmdlet wordt uitgevoerd in een externe sessie of op een externe computer. Voer een computernaam of een sessieobject in, zoals de uitvoer van een New-CimSession of Get-CimSession cmdlet. De standaardwaarde is de huidige sessie op de lokale computer.

Type:CimSession[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van computernamen. De cmdlet past de configuratie-instellingen toe op de computers die met deze parameter worden opgegeven.

Type:String[]
Aliassen:CN, ServerName
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersnaam en wachtwoord, als een PSCredential-object, voor de doelcomputer. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobName

Hiermee geeft u een beschrijvende naam voor een taak. Als u deze parameter opgeeft, wordt de cmdlet uitgevoerd als een taak en wordt een Job-object geretourneerd.

Standaard wijst Windows PowerShell de naam JobN toe waarbij N een geheel getal is.

Als u de parameter Wait opgeeft, geeft u deze parameter niet op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ThrottleLimit

Hiermee geeft u het maximum aantal gelijktijdige bewerkingen op dat kan worden ingesteld om de cmdlet uit te voeren. Als deze parameter wordt weggelaten of als er een waarde van 0 wordt ingevoerd, berekent Windows PowerShell een optimale beperkingslimiet voor de cmdlet op basis van het aantal CIM-cmdlets dat op de computer wordt uitgevoerd. De beperkingslimiet is alleen van toepassing op de huidige cmdlet, niet op de sessie of op de computer.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Wait

Geeft aan dat de cmdlet de console blokkeert totdat alle configuratietaken zijn voltooid.

Als u deze parameter opgeeft, geeft u de parameter JobName niet op.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False