Start-CMObjectTracking

Referenz

Modul:: ConfigurationManager

Starten Sie die Nachverfolgung von SMS-Anbieterobjekten, die von PowerShell verwendet werden, um sie freizugeben.

Syntax

Start-CMObjectTracking
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Verwenden Sie Start-CMObjectTracking zum Nachverfolgen von SMS-Anbieterobjekten, die von der PowerShell-Laufzeit verwendet werden. Verwenden Sie dann Disconnect-CMTrackedObject, um diese Ressourcen zu bereinigen, wenn sie nicht mehr benötigt werden.

Wenn Sie Start-CMObjectTrackingausführen, verfolgt die PowerShell-Laufzeit IResultObject-Objekte nach, die von Configuration Manager-Cmdlets erstellt wurden. Geben Sie für Objekte, die nicht manuell bereinigt .Dispose() werden, diese mithilfe von Disconnect-CMTrackedObject für ein einzelnes Objekt frei.

Nachdem ein Objekt freigegeben wurde, kann es nicht mehr wiederverwendet oder über die Objektpipeline an ein anderes Cmdlet übergeben werden.

Stop-CMObjectTracking kann verwendet werden, um die Objektverfolgung zu deaktivieren. Zuvor zugewiesene Objekte bleiben aktiv.

Nicht freigegebene Ressourcen können dazu führen, dass der SMS-Anbieter Fehler bei Kontingentverletzungen auslöst. Diese Kontingentprobleme manifestieren sich in der Regel durch die Arbeit mit großen Sätzen von SMS-Anbieterobjekten oder in umgebungen mit langer Laufzeit.

Hinweis

Dieses Feature ist experimentell und kann in einer zukünftigen Version geändert oder entfernt werden.

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel1

Der erste Befehl aktiviert die Objektverfolgung. Der zweite Befehl gibt ein einzelnes Objekt frei, das von der variablen $obj angegeben wird. Der dritte Befehl gibt alle nachverfolgten Objekte frei. Mit dem letzten Befehl wird die Objektverfolgung deaktiviert.

Start-CMObjectTracking

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

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Stop-CMObjectTracking

Parameter

-Confirm

Fügen Sie diesen Parameter hinzu, um zur Bestätigung aufzufordern, bevor das Cmdlet ausgeführt wird.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Keine

Ausgaben

System.Object