Invoke-CMDeviceRetire

Invoke-CMDeviceRetire

Retires devices.

構文

Parameter Set: SearchByNameMandatory
Invoke-CMDeviceRetire -DeviceName <String[]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Invoke-CMDeviceRetire -DeviceId <String[]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Invoke-CMDeviceRetire -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]




詳細説明

The Invoke-CMDeviceRetire cmdlet retires one or more devices. A retired device is no longer active in Microsoft System Center 2012 Configuration Manager. It does not receive new policies or policy updates. Retired devices remain listed until a maintenance task removes them.

パラメーター

-DeviceId<String[]>

Specifies an array of device IDs.


エイリアス

ResourceId

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-DeviceName<String[]>

Specifies an array of device names.


エイリアス

Name

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Force

Performs the action without a confirmation message.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-InputObject<IResultObject>

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


エイリアス

なし

必須?

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 (http://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

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

出力

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

Example 1: Retire a named device

This command retires the computer named Computer073.


PS C:\> Invoke-CMDeviceRetire -DeviceName "Computer073"

関連トピック

コミュニティの追加

追加
表示: