Publish-DscConfiguration
语法
ComputerNameSet （默认值）
Publish-DscConfiguration
[-Path] <String>
[[-ComputerName] <String[]>]
[-Force]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Publish-DscConfiguration
[-Path] <String>
-CimSession <CimSession[]>
[-Force]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Publish-DscConfiguration cmdlet 在一组计算机上发布 Windows PowerShell Desired State Configuration （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 的输出。 默认值为本地计算机上的当前会话。
参数属性
参数集
CimSessionSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ComputerName
指定此 cmdlet 发布配置的一台或多台计算机。
参数属性
| 类型: | String[]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 中国区, 服务器名称 |
参数集
ComputerNameSet
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Credential
指定用于访问目标设备的凭据。
参数属性
参数集
ComputerNameSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
强制 cmdlet 完成。 如果本地 Configuration Manager 刷新模式设置为 PULL，则此参数的用法将更改为 PUSH，并启用 DSC 配置的发布。 此外，如果存在挂起的 DSC 配置，则此参数的用法将覆盖该挂起的配置。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Path
指定一个路径，其中包含要发布到目标计算机的配置。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ThrottleLimit
指定可以建立以运行 cmdlet 的最大并发操作数。 如果省略此参数或输入 0 值，则 Windows PowerShell 会根据计算机上运行的 CIM cmdlet 数计算 cmdlet 的最佳限制。 限制限制仅适用于当前 cmdlet，不适用于会话或计算机。
参数属性
| 类型: | Int32
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
