Start-CMClientSettingDeployment

  • 参考
模块:
ConfigurationManager

(已弃用) 将客户端设置部署到集合中的设备。

语法

Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

Start-CMClientSettingDeployment cmdlet 将客户端设置部署到 Configuration Manager 集合中的设备。 使用客户端设置对象的名称或 ID 指定客户端设置对象，或者可以使用 Get-CMClientSetting cmdlet 获取客户端设置对象。 使用其名称或 ID 指定要将设置应用到的集合，或者可以使用 Get-CMDeviceCollection cmdlet 获取设备集合。

有关客户端设置的详细信息，请参阅关于 Configuration Manager 中的客户端设置。

重要

从版本 2107 开始，此 cmdlet 已弃用，并可能在将来的版本中删除。 请改用 New-CMClientSettingDeployment cmdlet。

示例

示例 1：使用客户端设置对象的 ID 将其部署到命名集合

PS XYZ:\> Start-CMClientSettingDeployment -ClientSettingId "CSI1023" -CollectionName "General Computer Collection"

此命令开始部署名为“常规计算机集合”的集合的 ID 为 CSI1023 的客户端设置对象。

示例 2：使用变量部署客户端设置对象

PS XYZ:\> $CSID = Get-CMClientSetting -Id "CSI1023"
PS XYZ:\> Start-CMClientSettingDeployment -ClientSetting $CSID -CollectionName "General Computer Collection"

第一个命令获取 ID 为 CSI1023 的客户端设置对象，并将其保存在 $CSID 变量中。

第二个命令开始将 $CSID 变量中的客户端设置对象部署到名为 General Computer Collection 的集合。

参数

-ClientSetting

指定客户端设置对象。 若要获取客户端设置对象，请使用 Get-CMClientSetting cmdlet。

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ClientSettingId

指定客户端设置对象的 ID。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ClientSettingName

指定客户端设置对象的名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Collection

指定Configuration Manager集合对象。 若要获取集合对象，请使用 Get-CMDeviceCollection cmdlet。 Configuration Manager将客户端设置应用于此集合的成员。

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CollectionId

指定Configuration Manager集合的 ID。 Configuration Manager将客户端设置应用于此集合的成员。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

指定Configuration Manager集合的名称。 Configuration Manager将客户端设置应用于此集合的成员。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

Type:SwitchParameter
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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object