通过

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。

类型:IResultObject
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CollectionId

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CollectionName

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-DeploymentId

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

类型:String
别名:AssignmentUniqueID, ConfigurationPolicyDeploymentID
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Fast

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

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

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

类型:IResultObject
别名:ConfigurationPolicy
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Name

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

类型:String
别名:ConfigurationPolicyName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-SmsObjectId

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

类型:Int32
别名:CI_ID, ConfigurationPolicyID
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Summary

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject[]

IResultObject

IResultObject[]

IResultObject