Dela via

Update-DscConfiguration

  • Referens
Modul:
PSDesiredStateConfiguration

Kontrollerar hämtningsservern efter 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 den samlade uppdateringen 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 när konfigurationen tillämpas.

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 objektet CimSession i variabeln $Session. Kommandot uppmanar dig att ange ett lösenord. Om du vill ha mer information skriver du Get-Help New-CimSession.

Det andra kommandot uppdaterar datorn som anges i CimSession lagras i $Session. Kommandot anger parametern Wait. 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 en New-CimSession- eller Get-CimSession cmdlet. Standardvärdet är den aktuella sessionen på den lokala datorn.

Typ:CimSession[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputerName

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

Typ:String[]
Alias:CN, ServerName
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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. Om du vill ha mer information skriver du Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 Job-objekt.

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

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 på 0 anges 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 på datorn.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False