Publish-DscConfiguration
將 DSC 設定發佈到一組電腦。
Syntax
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
Cmdlet 會在 Publish-DscConfiguration 一組電腦上發佈Windows PowerShell Desired State Configuration (DSC) 組態檔。 此 Cmdlet 不會套用設定。
設定是由 Start-DscConfiguration Cmdlet 搭配UseExisting 參數搭配使用時所套用，或 DSC 引擎執行其一致性循環時所套用。 DSC 引擎也稱為「本機設定管理員 (LCM)」。
傳遞多個設定文件的片段時，此 Cmdlet 特別有用。 傳遞多個設定文件片段時，它們會覆寫較舊的設定文件片段。
範例
範例 1︰將設定發佈到遠端電腦
Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)此命令會將設定發佈到遠端電腦。 執行此 Cmdlet 的使用者應為遠端電腦上的系統管理員。
參數
-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
指定用來存取目標裝置的認證。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
強制此 Cmdlet 完成。 如果「本機設定管理員」重新整理模式設為「提取」，使用此參數會將其變更為「推入」，並會發佈 DSC 設定。 此外，如果有擱置中的 DSC 設定，使用此參數會覆寫該擱置中設定。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定一個路徑，其中包含要發佈到目標電腦的設定。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
