Update-DscConfiguration

參考

模組:: PSDesiredStateConfiguration

檢查提取伺服器是否有更新的組態並加以套用。

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

Cmdlet Update-DscConfiguration 會連線到提取伺服器，如果設定與節點上的目前內容不同，則會下載設定，然後將設定套用至電腦。

此 Cmdlet 僅適用于Windows RT 8.1、Windows 8.1 和 Windows Server 2012 R2 的 2014 年 11 月更新彙總套件。

範例

範例 1︰更新組態

Update-DscConfiguration -Wait -Verbose

執行此命令之後，伺服器會連線到已註冊的提取服務、下載最新的指派組態，然後加以套用。 Wait和Verbose參數是選擇性參數。以互動方式運作時，這些參數會在套用設定時啟用有關進度和成功或失敗的即時意見反應。

範例 2：透過 CIM 會話連線來更新設定

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

第一個命令會使用 New-CimSession Cmdlet 建立 CIM 會話，然後將 CimSession 物件儲存在變數中 $Session 。此命令會提示您輸入密碼。如需詳細資訊，請鍵入 Get-Help New-CimSession。

第二個命令會更新儲存在中 $SessionCimSession中指定的電腦。此命令會指定 Wait 參數。主控台要到目前的命令完成之後，才會接受其他命令。

參數

-CimSession

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱稱或會話物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上的目前工作階段。

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

-ComputerName

指定電腦名稱的陣列。此 Cmdlet 會將組態設定套用到此參數指定的電腦。

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

-Confirm

在執行 Cmdlet 前提示您確認。

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

-Credential

指定目標電腦的使用者名稱和密碼，做為 PSCredential 物件。若要取得 PSCredential 物件，請使用 Get-Credential Cmdlet。如需詳細資訊，請鍵入 Get-Help Get-Credential。

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

-JobName

指定工作的好記名稱。如果您指定這個參數，Cmdlet 就會當做一個工作執行，而且它會傳回 Job 物件。

根據預設，Windows PowerShell指派名稱 JobN，其中 N 是整數。

如果您指定 Wait 參數，請不要指定此參數。

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

-ThrottleLimit

指定為執行 Cmdlet 可建立的最大並行作業數。如果省略此參數或輸入的值 0 ，則Windows PowerShell根據電腦上執行的 CIM Cmdlet 數目，計算 Cmdlet 的最佳節流限制。節流限制僅適用於目前 Cmdlet，不適用於工作階段或電腦。

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

-Wait

表示 Cmdlet 會封鎖主控台，直到它完成所有設定工作為止。

如果您指定此參數，請不要指定 JobName 參數。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

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