Get-CMObjectLockDetails

  • Referenz
Modul:
ConfigurationManager

Ruft die Details einer SEDO-Sperre für ein Objekt ab.

Syntax

Get-CMObjectLockDetails
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um die SEDO-Sperrdetails für ein Objekt abzurufen. Configuration Manager SEDO (Serialized Editing of Distributed Objects) ist ein Mechanismus zum Zuweisen von Sperren für global replizierte Objekte. Wenn ein Benutzer ein Objekt bearbeiten und speichern möchte, muss er eine Sperre von der Website erhalten. Der Standort weist dem Benutzer eine Sperre für dieses Objekt, auf dem Computer und am Standort zu. Während der Benutzer über die Sperre verfügt, kann niemand anderes das Objekt bearbeiten.

Weitere Informationen finden Sie unter Configuration Manager SEDO.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen von Objektsperrdetails für eine Anwendung

Dieses Beispiel zeigt die Ausgabe für die Sperrdetails einer Anwendung.

PS XYZ:\> Get-CMApplication -Name "Central app" | Get-CMObjectLockDetails


SmsProviderObjectPath     : __PARAMETERS
AssignedMachine           : DESKTOP-VKJQV9N
AssignedObjectLockContext : 36b0ab13-ebe3-4977-8aab-19a701b1c1b6
AssignedSiteCode          : XYZ
AssignedTimeUTC           : 1/5/2021 08:08:39
AssignedUser              : CONTOSO\jqpublic
LockState                 : 1
ReturnValue               : 0

Wenn es keine Sperre für das Objekt gibt, ist die Ausgabe ähnlich, aber viele der Eigenschaften sind leer. Die Werte sind nicht $null, sondern eine leere Zeichenfolge "".

Beispiel 2: Überprüfen auf eine Sperre vor dem Bearbeiten eines Objekts

In diesem Beispiel wird zunächst das Cmdlet Get-CMApplication verwendet, um ein App-Objekt abzurufen. Anschließend wird das Cmdlet Get-CMObjectLockDetails für diese App verwendet und der Variablen lockUser die AssignedUser-Eigenschaft zugewiesen. Wenn dieser Wert leer ist, wird das Cmdlet Set-CMApplication verwendet, um den Namen der App zu ändern. Wenn die variable lockUser nicht leer ist, wird eine Warnung ausgegeben.

$app617 = Get-CMApplication -ApplicationName "LOB app v6.17"
$lockUser = ($app617 | Get-CMObjectLockDetails).AssignedUser

if ( $lockUser -eq "" ) {
  Set-CMApplication -InputObject $app617 -NewName "Central app v6.17"
} else {
  Write-Warning "There's a SEDO lock on app $($app617.LocalizedDisplayName)"
}

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

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

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

-InputObject

Geben Sie ein Configuration Manager Objekt an, das von einem anderen Cmdlet ausgegeben wird. Verwenden Sie beispielsweise das Cmdlet Get-CMApplication , um ein Anwendungsobjekt abzurufen.

Eine Liste der Objekte, die SEDO-fähig sind, finden Sie unter Configuration Manager SEDO.

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object