Compartilhar via

Disconnect-CMTrackedObject

  • Referência
Módulo:
ConfigurationManager

Limpe objetos do PowerShell não utilizados para evitar erros de violação de cota do Provedor de SMS.

Sintaxe

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

Description

Ao usar Start-CMObjectTracking para rastrear objetos do Provedor de SMS usados pelo runtime do PowerShell, use esse cmdlet para limpar esses recursos quando eles não forem mais necessários.

Quando você executa Start-CMObjectTracking, o runtime do PowerShell rastreia objetos IResultObject criados por cmdlets Configuration Manager. Para objetos que não são limpos manualmente com .Dispose(), recupere-os usando Disconnect-CMTrackedObject em um objeto individual.

Depois que um objeto é recuperado, ele não pode mais ser reutilizado ou passado para outro cmdlet por meio do pipeline de objeto.

Stop-CMObjectTracking pode ser usado para desativar o rastreamento de objetos. Os objetos alocados anteriormente permanecem ativos.

Recursos não reclamados podem fazer com que o Provedor de SMS aumente erros de violação de cota. Esses problemas de cota normalmente se manifestam por trabalhar com grandes conjuntos de objetos provedores de SMS ou em ambientes de longa execução.

Observação

Esse recurso é experimental e pode estar sujeito a alterações ou remoção em uma versão futura.

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1

O primeiro comando ativa o rastreamento de objetos. O segundo comando recupera um único objeto especificado pela variável $obj . O terceiro comando recupera todos os objetos rastreados. O último comando desativa o rastreamento 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

Adicione esse parâmetro para recuperar todos os objetos rastreados.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Adicione esse parâmetro para solicitar a confirmação antes que o cmdlet seja executado.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Adicione esse parâmetro para executar o comando sem pedir confirmação.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique qualquer IResultObject que você criou anteriormente com um cmdlet Configuration Manager.

Tipo:IDisposable[]
Aliases:InputObjects
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.IDisposable[]

Saídas

System.Object