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>]

说明

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 完成。如果本地配置管理器刷新模式设置为 PULL，则使用此参数会将它更改为 PUSH，并启用 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

通过