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