Partager via

Get-CMObjectLockDetails

  • Référence
Module:
ConfigurationManager

Obtenez les détails d’un verrou SEDO pour un objet.

Syntaxe

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

Description

Utilisez cette applet de commande pour obtenir les détails du verrou SEDO pour un objet . Configuration Manager SEDO (Serialized Editing of Distributed Objects) est un mécanisme permettant d’affecter des verrous à des objets répliqués globalement. Si un utilisateur souhaite modifier et enregistrer un objet, il doit obtenir un verrou à partir du site. Le site attribue un verrou à l’utilisateur pour cet objet, sur son ordinateur et sur le site. Tant que l’utilisateur dispose du verrou, personne d’autre ne peut modifier l’objet.

Pour plus d’informations, consultez Configuration Manager SEDO.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir les détails du verrouillage d’objet pour une application

Cet exemple montre la sortie des détails de verrouillage d’une application.

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

Lorsqu’il n’y a pas de verrou sur l’objet, la sortie est similaire, mais la plupart des propriétés sont vides. Les valeurs ne sont pas $null, mais une chaîne ""vide .

Exemple 2 : Rechercher un verrou avant de modifier un objet

Cet exemple utilise d’abord l’applet de commande Get-CMApplication pour obtenir un objet d’application. Il utilise ensuite l’applet de commande Get-CMObjectLockDetails pour cette application et affecte la propriété AssignedUser à la variable lockUser. Si cette valeur est vide, elle utilise l’applet de commande Set-CMApplication pour modifier le nom de l’application. Si la variable lockUser n’est pas vide, elle écrit un avertissement.

$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)"
}

Paramètres

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet Configuration Manager qui est généré à partir d’une autre applet de commande. Par exemple, pour obtenir un objet d’application, utilisez l’applet de commande Get-CMApplication .

Pour obtenir la liste des objets qui sont activés pour SEDO, consultez Configuration Manager SEDO.

Type:IResultObject
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object