Compartilhar via

Disconnect-CMTrackedObject

  • Referência
Módulo:
ConfigurationManager

Limpe os objetos do PowerShell não utilizados para evitar erros de violação de quota do Fornecedor de SMS.

Sintaxe

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

Description

Quando utilizar Start-CMObjectTracking para controlar os objetos do Fornecedor de SMS utilizados pelo runtime do PowerShell, utilize este cmdlet para limpar estes recursos quando já não forem necessários.

Quando executa Start-CMObjectTracking, o runtime do PowerShell controla os objetos IResultObject criados pelos cmdlets do Configuration Manager. Para objetos que não são limpos manualmente com .Dispose(), recupere-os utilizando Disconnect-CMTrackedObject num objeto individual.

Depois de um objeto ser recuperado, já não pode ser reutilizado ou transmitido para outro cmdlet através do pipeline de objetos.

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

Os recursos não reclamados podem fazer com que o Fornecedor de SMS crie erros de violação de quota. Normalmente, estes problemas de quota manifestam-se ao trabalhar com grandes conjuntos de objetos do Fornecedor de SMS ou em ambientes de execução prolongada.

Observação

Esta funcionalidade é experimental e pode estar sujeita a alterações ou remoção numa versão futura.

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

Exemplos

Exemplo 1

O primeiro comando ativa o controlo de objetos. O segundo comando recupera um único objeto especificado pela variável $obj . O terceiro comando recupera todos os objetos controlados. O último comando desativa o controlo 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 este parâmetro para recuperar todos os objetos controlados.

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

-Confirm

Adicione este parâmetro para pedir confirmação antes da execução do cmdlet.

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

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. 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 este 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

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 tenha criado anteriormente com um cmdlet do 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