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

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

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-Force

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

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

-ForceWildcardHandling

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

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

-InputObject

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

Type:IDisposable[]
Aliases:InputObjects
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

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

输入

System.IDisposable[]

输出

System.Object