Invoke-CMDeviceRetire

リファレンス

モジュール:: ConfigurationManager

デバイスを廃止します。

構文

Invoke-CMDeviceRetire
      [-Cancel]
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-CMDeviceRetire
      [-Cancel]
      [-Force]
      -Id <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-CMDeviceRetire
      [-Cancel]
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Invoke-CMDeviceRetire コマンドレットは、1 つ以上のデバイスを廃止します。廃止されたデバイスは Configuration Manager でアクティブではなくなりました。新しいポリシーやポリシー更新プログラムは受け取らない。廃止されたデバイスは、メンテナンスタスクによって削除されるまで一覧表示されたままです。

注意

Configuration Manager サイトドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。詳細については、「Getting started」を参照してください。

例

例 1: 名前付きデバイスを廃止する

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

このコマンドは、Computer073 という名前のコンピューターを廃止します。

パラメーター

-Cancel

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
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

-Force

ユーザーの確認を求めることなく、コマンドを強制的に実行します。

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

-Id

Type:	Int32
Aliases:	DeviceId, ResourceId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

CMDevice オブジェクトを指定します。 CMDevice オブジェクトを取得するには、Get-CMDevice コマンドレットを使用します。

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

-Name

Type:	String
Aliases:	DeviceName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

Get-CMDevice