Disconnect-CMTrackedObject

  • Riferimento
Modulo:
ConfigurationManager

Pulire gli oggetti di PowerShell inutilizzati per evitare errori di violazione della quota del provider SMS.

Sintassi

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

Descrizione

Quando si usa Start-CMObjectTracking per tenere traccia degli oggetti provider SMS usati dal runtime di PowerShell, usare questo cmdlet per pulire queste risorse quando non sono più necessarie.

Quando si esegue Start-CMObjectTracking, il runtime di PowerShell tiene traccia degli oggetti IResultObject creati dai cmdlet di Configuration Manager. Per gli oggetti che non vengono puliti manualmente con .Dispose(), recuperarli usando Disconnect-CMTrackedObject su un singolo oggetto.

Una volta recuperato, un oggetto non può più essere riutilizzato o passato a un altro cmdlet tramite la pipeline dell'oggetto.

È possibile usare Stop-CMObjectTracking per disattivare il rilevamento degli oggetti. Gli oggetti allocati in precedenza rimangono attivi.

Le risorse non reclamate possono causare errori di violazione della quota da parte del provider SMS. Questi problemi di quota si manifestano in genere dall'uso di set di grandi dimensioni di oggetti provider SMS o in ambienti a esecuzione prolungata.

Nota

Questa funzionalità è sperimentale e può essere soggetta a modifiche o rimozione in una versione futura.

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

Il primo comando attiva il rilevamento degli oggetti. Il secondo comando recupera un singolo oggetto specificato dalla variabile $obj . Il terzo comando recupera tutti gli oggetti rilevati. L'ultimo comando disattiva il rilevamento degli oggetti.

Start-CMObjectTracking

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

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Stop-CMObjectTracking

Parametri

-All

Aggiungere questo parametro per recuperare tutti gli oggetti rilevati.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Aggiungere questo parametro per richiedere conferma prima dell'esecuzione del cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Aggiungere questo parametro per eseguire il comando senza richiedere conferma.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare qualsiasi IResultObject creato in precedenza con un cmdlet di Configuration Manager.

Tipo:IDisposable[]
Alias:InputObjects
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

System.IDisposable[]

Output

System.Object