Update-DscConfiguration

  • Referens
Modul:
PSDesiredStateConfiguration

Kontrollerar om pull-servern har en uppdaterad konfiguration och tillämpar den.

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

Cmdleten Update-DscConfiguration ansluter till en pull-server, laddar ned konfigurationen om den skiljer sig från vad som är aktuellt på noden och tillämpar sedan konfigurationen på datorn.

Den här cmdleten är endast tillgänglig som en del av samlad uppdatering i november 2014 för Windows RT 8.1, Windows 8.1 och Windows Server 2012 R2.

Exempel

Exempel 1: Uppdatera en konfiguration

Update-DscConfiguration -Wait -Verbose

När du har kört det här kommandot ansluter servern till den registrerade pull-tjänsten, laddar ned den senaste tilldelade konfigurationen och tillämpar den sedan. Parametrarna Wait och Verbose är valfria. När du arbetar interaktivt möjliggör dessa parametrar tillsammans feedback i realtid om förlopp och framgång eller fel vid tillämpning av konfigurationen.

Exempel 2: Uppdatera en konfiguration genom att ansluta via en CIM-session

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

Det första kommandot skapar en CIM-session med hjälp av cmdleten New-CimSession och lagrar sedan CimSession-objektet i variabeln $Session . Kommandot uppmanar dig att ange ett lösenord. För mer information ange Get-Help New-CimSession.

Det andra kommandot uppdaterar datorn som anges i CimSession som lagras i $Session. Kommandot anger parametern Vänta . Konsolen accepterar inte ytterligare kommandon förrän det aktuella kommandot har slutförts.

Parametrar

-CimSession

Kör cmdleten i en fjärrsession eller på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från cmdleten New-CimSession eller Get-CimSession . Standardinställningen är den aktuella sessionen på den lokala datorn.

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

-ComputerName

Anger en matris med datornamn. Cmdleten tillämpar konfigurationsinställningarna på de datorer som den här parametern anger.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Credential

Anger ett användarnamn och lösenord som ett PSCredential-objekt för måldatorn. Om du vill hämta ett PSCredential-objekt använder du cmdleten Get-Credential . För mer information ange Get-Help Get-Credential.

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

-JobName

Anger ett eget namn för ett jobb. Om du anger den här parametern körs cmdleten som ett jobb och returnerar ett jobbobjekt .

Som standard tilldelar Windows PowerShell namnet JobN där N är ett heltal.

Om du anger parametern Vänta ska du inte ange den här parametern.

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

-ThrottleLimit

Anger det maximala antalet samtidiga åtgärder som kan upprättas för att köra cmdleten. Om den här parametern utelämnas eller ett värde anges 0 beräknar Windows PowerShell en optimal begränsningsgräns för cmdleten baserat på antalet CIM-cmdletar som körs på datorn. Begränsningsgränsen gäller endast för den aktuella cmdleten, inte för sessionen eller datorn.

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

-Wait

Anger att cmdleten blockerar konsolen tills den har slutfört alla konfigurationsuppgifter.

Om du anger den här parametern ska du inte ange parametern JobName .

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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