Get-CMConfigurationPolicyDeployment
获取配置策略部署。
语法
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