Clear-CMPxeDeployment

[アーティクル]
11/16/2015

Clear-CMPxeDeployment

Clears the status of the most recent PXE deployment in Configuration Manager.

構文

Parameter Set: SearchByNameMandatory
Clear-CMPxeDeployment -DeviceCollectionName <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Clear-CMPxeDeployment -DeviceCollectionId <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory__Device
Clear-CMPxeDeployment -ResourceId <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNameMandatory_Device
Clear-CMPxeDeployment -DeviceName <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Clear-CMPxeDeployment -DeviceCollection <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory__Device
Clear-CMPxeDeployment -Device <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Clear-CMPxeDeployment cmdlet clears the status of the most recent Preboot EXecution Environment (PXE) deployment in Microsoft System Center 2012 Configuration Manager.

You can redeploy a required PXE deployment for a collection of devices. Clear the status of the last PXE deployment assigned to that System Center 2012 Configuration Manager collection. System Center 2012 Configuration Manager redeploys the most recent required deployments.

パラメーター

-Device<IResultObject>

Specifies a device object. To obtain a device object, use the Get-CMDevice cmdlet.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-DeviceCollection<IResultObject>

Specifies a device collection object. To obtain a device collection object, use the Get-CMDeviceCollection cmdlet.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-DeviceCollectionId<String[]>

Specifies an array of IDs of device collections.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-DeviceCollectionName<String[]>

Specifies an array of names of device collections.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-DeviceName<String[]>

Specifies an array of names of devices.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-ResourceId<String[]>

Specifies an array of IDs for resources. The cmdlet clears the status of the PXE deployment for these resources.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?	false
位置は?	named
既定値	false
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?	false
位置は?	named
既定値	false
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Clear a PXE deployment for a device collection

This command clears a PXE deployment identified with a device collection ID.

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

Clear-CMPxeDeployment