Invoke-CMDeviceRetire

參考

模組:: ConfigurationManager

停用裝置。

Syntax

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

Description

CMDeviceRetire Cmdlet 會停用一或多個裝置。已停用的裝置在 Configuration Manager 中已不再是作用中的。它不會接收新的原則或原則更新。停用的裝置仍會列出，直到維護工作移除為止。

注意

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

範例

範例1：報廢已命名的裝置

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

這個命令會停用名為 Computer073 的電腦。

參數

-Confirm

執行 Cmdlet 之前提示您確認。

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

-InputObject

指定 CMDevice 物件。若要取得 CMDevice 物件，請使用 CMDevice Cmdlet。

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

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。不會執行 Cmdlet。

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

-取消

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

-名稱

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

-識別碼

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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件

CMDevice