Clear-CMPxeDeployment

在 Configuration Manager 中清除最近的 PXE 部署狀態。

Syntax

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>]

Description

CMPxeDeployment 指令程式會清除 [設定管理員] 中「PXE) 部署」的最近一次啟動執行 (環境的狀態。

您可以為裝置的集合重新部署必要的 PXE 部署。 清除指派給該 Configuration Manager 集合之最後一個 PXE 部署的狀態。 Configuration Manager redeploys 最新的必要部署。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\> 。 如需詳細資訊,請參閱 快速入門。

範例

範例1:清除裝置集合的 PXE 部署

PS XYZ:\>Clear-CMPxeDeployment -DeviceCollectionId "SMS00072"

此命令會清除以裝置集合識別碼識別的 PXE 部署。

參數

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DeviceCollection

會指定裝置集合物件。 若要取得裝置集合物件,請使用 CMDeviceCollection Cmdlet。

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

-DeviceCollectionId

指定裝置集合的 IDs 陣列。

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

會指定資源的 IDs 陣列。 此 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

-裝置

會指定 device 物件。 若要取得 device 物件,請使用 CMDevice Cmdlet。

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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件