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 cmdlet 停用一个或多个设备。停用的设备在 Configuration Manager 中不再处于活动状态。它不会接收新策略或策略更新。停用的设备将一直列出，直到维护任务删除它们。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。有关详细信息，请参阅入门。

示例

示例 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

提示你在运行 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

-Id

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

-InputObject

指定 CMDevice 对象。若要获取 CMDevice 对象，请使用 Get-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:	String
Aliases:	DeviceName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

Get-CMDevice