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>]
Description
Clear-CMPxeDeployment Cmdlet 會清除 Configuration Manager 中最新開機前 EXecution Environment (PXE) 部署的狀態。
您可以重新部署裝置集合所需的 PXE 部署。 清除指派給該 Configuration Manager 集合的最後一個 PXE 部署狀態。 Configuration Manager 會重新部署最新的必要部署。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:清除裝置集合的 PXE 部署
PS XYZ:\>Clear-CMPxeDeployment -DeviceCollectionId "SMS00072"
此命令會清除以裝置集合標識碼識別的 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
指定裝置集合的識別碼陣列。
類型: | 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
指定資源的識別子陣列。 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