Update-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

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

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

De Update-DscConfiguration cmdlet maakt verbinding met een pull-server, downloadt de configuratie als deze verschilt van wat er op het knooppunt actueel is en past vervolgens de configuratie 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

Na het uitvoeren van deze opdracht maakt de server verbinding met de geregistreerde pull-service, downloadt de meest recent toegewezen configuratie en past deze vervolgens toe. De parameters Wachten en Uitgebreid zijn optioneel. Wanneer u interactief werkt, maken deze parameters gecombineerd realtime feedback over de voortgang en succes of mislukking bij het toepassen van de configuratie mogelijk.

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 New-CimSession cmdlet en slaat u vervolgens het CimSession-object op in de $Session variabele. De opdracht vraagt u om een wachtwoord. Typ Get-Help New-CimSession voor meer informatie.

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

Parameters

-CimSession

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

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

-ComputerName

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

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Credential

Hiermee geeft u een gebruikersnaam en wachtwoord, als een PSCredential-object , voor de doelcomputer. Gebruik de Get-Credential cmdlet om een PSCredential-object te verkrijgen. Typ Get-Help Get-Credential voor meer informatie.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 taakobject geretourneerd.

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

Als u de parameter Wait opgeeft, moet u deze parameter niet opgeven.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Wait

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

Als u deze parameter opgeeft, moet u de parameter JobName niet opgeven.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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