Publish-DscConfiguration

  • 參考
模組:
PSDesiredStateConfiguration

將 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