Share via

Clear-CMPxeDeployment

  • 参考
模块:
ConfigurationManager

清除 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 之前进行确认。

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

-Device

指定设备对象。 若要获取设备对象，请使用 Get-CMDevice cmdlet。

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

-DeviceCollection

指定设备集合对象。 若要获取设备集合对象，请使用 Get-CMDeviceCollection cmdlet。

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

-DeviceCollectionId

指定设备集合的 ID 数组。

Type:String[]
Aliases:CollectionId, DeviceCollectionIds, CollectionIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceCollectionName

指定设备集合的名称数组。

Type:String[]
Aliases:CollectionName, DeviceCollectionNames, CollectionNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

指定设备名称的数组。

Type:String[]
Aliases:DeviceNames
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

-ForceWildcardHandling

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

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

-ResourceId

指定资源的一组 ID。 此 cmdlet 可清除这些资源的 PXE 部署状态。

Type:Int32[]
Aliases:ResourceIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object