Clear-CMPxeDeployment
清除 Configuration Manager 中最新 PXE 部署的状态。
语法
Clear-CMPxeDeployment
-DeviceCollection <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Clear-CMPxeDeployment
-Device <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Clear-CMPxeDeployment
-DeviceCollectionId <String[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Clear-CMPxeDeployment
-DeviceCollectionName <String[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Clear-CMPxeDeployment
-DeviceName <String[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Clear-CMPxeDeployment
-ResourceId <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Clear-CMPxeDeployment cmdlet 清除 Configuration Manager 中最新的预启动 EXecution 环境 (PXE) 部署的状态。
可以为设备集合重新部署所需的 PXE 部署。 清除分配给该 Configuration Manager 集合的最后一个 PXE 部署的状态。 Configuration Manager 会重新部署最新的所需部署。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：清除设备集合的 PXE 部署
PS XYZ:\>Clear-CMPxeDeployment -DeviceCollectionId "SMS00072"此命令清除使用设备集合 ID 标识的 PXE 部署。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Device
指定设备对象。 若要获取设备对象，请使用 Get-CMDevice cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-DeviceCollection
指定设备集合对象。 若要获取设备集合对象，请使用 Get-CMDeviceCollection cmdlet。
| 类型: | IResultObject |
| 别名: | Collection |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-DeviceCollectionId
指定设备集合的 ID 数组。
| 类型: | String[] |
| 别名: | CollectionId, DeviceCollectionIds, CollectionIds |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeviceCollectionName
指定设备集合的名称数组。
| 类型: | String[] |
| 别名: | CollectionName, DeviceCollectionNames, CollectionNames |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeviceName
指定设备名称的数组。
| 类型: | String[] |
| 别名: | DeviceNames |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ResourceId
指定资源的 ID 数组。 cmdlet 清除这些资源的 PXE 部署状态。
| 类型: | Int32[] |
| 别名: | ResourceIds |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object