Share via

Get-CMConfigurationPolicyDeployment

  • 参考
模块:
ConfigurationManager

获取配置策略部署。

语法

Get-CMConfigurationPolicyDeployment
   [-Fast]
   [-Name <String>]
   [-Summary]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPolicyDeployment
   [-Fast]
   [-DeploymentId <String>]
   [-Summary]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPolicyDeployment
   [-Fast]
   [-InputObject <IResultObject>]
   [-Summary]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPolicyDeployment
   [-Fast]
   [-SmsObjectId <Int32>]
   [-Summary]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 可获取配置策略的一个或多个部署。 这些策略包括以下类型：

  • 用户数据和配置文件
  • OneDrive for Business配置文件
  • 远程连接配置文件
  • 公司资源访问
  • Microsoft Edge浏览器配置文件

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。 有关详细信息，请参阅 入门。

示例

示例 1：列出所有配置策略部署

此命令返回所有配置策略部署，并且仅显示名称和 ID。

Get-CMConfigurationPolicyDeployment -Fast | Select-Object AssignmentName,AssignmentID

示例 2：获取配置策略的所有部署

$policy = Get-CMConfigurationPolicy -Name "ODfB policy" -Fast

Get-CMConfigurationPolicyDeployment -InputObject $policy -Fast | Select-Object TargetCollectionID,StartTime,Enabled

参数

-Collection

指定集合对象。 此集合是配置策略部署的目标。 若要获取此对象，请使用 Get-CMCollection cmdlet。

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

-CollectionId

指定作为配置策略部署目标的集合 ID。 例如，XYZ00023。

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

-CollectionName

指定作为配置策略部署目标的集合名称。

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

-DeploymentId

指定部署的 ID。 此值是标准 GUID，与控制台中的部署 ID 和返回的对象的 AssignmentUniqueID 属性相同。

Type:String
Aliases:AssignmentUniqueID, ConfigurationPolicyDeploymentID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

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

-Fast

添加此参数不自动刷新延迟属性。 延迟属性包含检索效率相对低的值。 获取这些属性可能会导致额外的网络流量并减少 cmdlet 性能。

如果不使用此参数，该 cmdlet 将显示一条警告。 若要禁用此警告，请设置 $CMPSSuppressFastNotUsedCheck = $true 。

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

-ForceWildcardHandling

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

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

-InputObject

指定配置策略对象以获取其部署。 若要获取此对象，请使用 Get-CMConfigurationPolicy cmdlet。

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

-SmsObjectId

指定要获取其部署的配置策略的 ID。

Type:Int32
Aliases:CI_ID, ConfigurationPolicyID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Summary

添加此参数以返回 SMS_DeploymentSummary WMI 类 对象。

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

-名称

指定要获取其部署的配置策略的名称。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject[]

IResultObject

IResultObject[]

IResultObject