共用方式為

Publish-DscConfiguration

  • 參考
模組:
PSDesiredStateConfiguration

將 DSC 組態發佈至一組電腦。

語法

Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [[-ComputerName] <String[]>]
       [-Credential <PSCredential>]
       [-ThrottleLimit <Int32>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [-ThrottleLimit <Int32>]
       -CimSession <CimSession[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Publish-DscConfiguration Cmdlet 會在一組電腦上發佈 Windows PowerShell 預期狀態設定 （DSC） 組態檔。 此 Cmdlet 不會套用設定。 當 UseExisting 參數或 DSC 引擎執行其一致性週期時，Start-DscConfiguration Cmdlet 會套用組態。 DSC 引擎也稱為本機組態管理員 （LCM）。

傳遞多個組態檔的片段時，此 Cmdlet 特別有用。 傳遞多個設定檔片段時，會覆寫較舊的設定檔片段。

範例

範例 1：將設定發佈至遠端電腦

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

此命令會將設定發佈至遠端電腦。 執行 Cmdlet 的使用者應該是遠端電腦上的系統管理員。

參數

-CimSession

在遠端會話或遠端電腦上執行 Cmdlet。 輸入計算機名稱或會話物件，例如 New-CimSession 或 Get-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
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

強制 Cmdlet 完成。 如果本機設定管理員重新整理模式設定為 PULL，此參數的使用方式會將它變更為 PUSH，並啟用 DSC 設定的發行。 此外，如果暫止的 DSC 組態存在，則此參數的使用方式會覆寫擱置的設定。

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

-Path

指定包含發佈至目標計算機之組態的路徑。

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

-ThrottleLimit

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

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

-WhatIf

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

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