Disconnect-CMTrackedObject

  • Referencia
Módulo:
ConfigurationManager

Limpie los objetos de PowerShell sin usar para evitar errores de infracción de cuota del proveedor de SMS.

Syntax

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

Description

Cuando use Start-CMObjectTracking para realizar un seguimiento de los objetos de proveedor de SMS usados por el entorno de ejecución de PowerShell, use este cmdlet para limpiar estos recursos cuando ya no se necesiten.

Al ejecutar Start-CMObjectTracking, el entorno de ejecución de PowerShell realiza un seguimiento de los objetos IResultObject creados por Configuration Manager cmdlets. Para los objetos que no se limpian manualmente con .Dispose(), reclamelos mediante Disconnect-CMTrackedObject en un objeto individual.

Una vez reclamado un objeto, ya no se puede reutilizar ni pasar a otro cmdlet a través de la canalización de objetos.

Stop-CMObjectTracking se puede usar para desactivar el seguimiento de objetos. Los objetos asignados anteriormente permanecen activos.

Los recursos no reclamados pueden hacer que el proveedor de SMS genere errores de infracción de cuota. Estos problemas de cuota suelen manifestarse al trabajar con grandes conjuntos de objetos de proveedor de SMS o en entornos de larga duración.

Nota:

Esta característica es experimental y puede estar sujeta a cambios o eliminaciones en una versión futura.

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1

El primer comando activa el seguimiento de objetos. El segundo comando recupera un único objeto especificado por la variable $obj . El tercer comando reclama todos los objetos de seguimiento. El último comando desactiva el seguimiento de objetos.

Start-CMObjectTracking

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

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Stop-CMObjectTracking

Parámetros

-All

Agregue este parámetro para recuperar todos los objetos de los que se ha hecho un seguimiento.

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

-Confirm

Agregue este parámetro para solicitar confirmación antes de que se ejecute el cmdlet.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-Force

Agregue este parámetro para ejecutar el comando sin pedir confirmación.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-InputObject

Especifique cualquier IResultObject que haya creado anteriormente con un cmdlet Configuration Manager.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

System.IDisposable[]

Salidas

System.Object