Compartir a través de

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.

Sintaxis

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 los cmdlets de Configuration Manager. 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 de Configuration Manager, por ejemplo PS 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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

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

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

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

Tipo:IDisposable[]
Alias:InputObjects
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

System.IDisposable[]

Salidas

System.Object