共用方式為


Update-DscConfiguration

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

語法

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

Update-DscConfiguration Cmdlet 會連線到提取伺服器、如果與節點上目前的設定不同,則會下載設定,然後將設定套用至計算機。

此 Cmdlet 僅適用於 Windows RT 8.1、Windows 8.1 和 Windows Server 2012 R2 2014 年 11 月更新匯總的一部分。

範例

範例 1:更新設定

Update-DscConfiguration -Wait -Verbose

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

範例 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-CimSessionGet-CimSession Cmdlet 的輸出。 預設為本機電腦上的目前會話。

類型:CimSession[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ComputerName

指定計算機名稱的陣列。 Cmdlet 會將組態設定套用至此參數所指定的計算機。

類型:String[]
別名:CN, ServerName
Position:1
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

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

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-JobName

指定作業的易記名稱。 如果您指定此參數,Cmdlet 會以作業的形式執行,並傳回 Job 物件。

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

如果您指定 Wait 參數,請勿指定此參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ThrottleLimit

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

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Wait

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

如果您指定此參數,請勿指定 JobName 參數。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False