Disconnect-CMTrackedObject

模块:

ConfigurationManager

清理未使用的 PowerShell 对象以避免 SMS 提供程序配额冲突错误。

语法

Disconnect-CMTrackedObject
          [-Force]
          -InputObject <IDisposable[]>
          [-DisableWildcardHandling]
          [-ForceWildcardHandling]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Disconnect-CMTrackedObject
          [-All]
          [-Force]
          [-DisableWildcardHandling]
          [-ForceWildcardHandling]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

说明

使用 Start-CMObjectTracking 跟踪 PowerShell 运行时使用的 SMS 提供程序对象时，使用此 cmdlet 在不再需要这些资源时清理这些资源。

运行 Start-CMObjectTracking 时，PowerShell 运行时跟踪由 Configuration Manager cmdlet 创建的 IResultObject 对象。 对于未使用 .Dispose()手动清理的对象，请针对单个对象使用 Disconnect-CMTrackedObject 进行回收。

回收对象后，它不能再重复使用或通过对象管道传递给另一个 cmdlet。

Stop-CMObjectTracking 可用于关闭对象跟踪。 以前分配的对象保持活动状态。

未认领的资源可能会导致 SMS 提供程序引发配额冲突错误。 这些配额问题通常表现在处理大型 SMS 提供程序对象集或在长时间运行的环境中。

注意

此功能是实验性的，在将来的版本中可能会发生更改或删除。

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

示例

示例 1

第一个命令打开对象跟踪。 第二个命令回收 由 $obj 变量指定的单个对象。 第三个命令回收所有跟踪的对象。 最后一个命令关闭对象跟踪。

Start-CMObjectTracking

# Reclaim a single tracked object
$obj | Disconnect-CMTrackedObject -Force

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Stop-CMObjectTracking

参数

-All

添加此参数以回收所有跟踪的对象。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Confirm

添加此参数以在 cmdlet 运行之前提示确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

添加此参数以在不要求确认的情况下运行命令。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

指定之前使用 Configuration Manager cmdlet 创建的任何 IResultObject 。

类型:	IDisposable[]
别名:	InputObjects
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

System.IDisposable[]

输出

System.Object

相关链接

• Start-CMObjectTracking
• Stop-CMObjectTracking