Share via

Get-CMObjectLockDetails

  • Referência
Módulo:
ConfigurationManager

Obtenha os detalhes de um bloqueio SEDO para um objeto.

Syntax

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

Description

Use este cmdlet para obter os detalhes do bloqueio SEDO para um objeto. Configuration Manager SEDO (Edição Serializada de Objetos Distribuídos) é um mecanismo para atribuir bloqueios a objetos replicados globalmente. Se um usuário quiser editar e salvar um objeto, ele precisará obter um bloqueio do site. O site atribui um bloqueio ao usuário para esse objeto, em seu computador e no site. Enquanto o usuário tem o bloqueio, ninguém mais pode editar o objeto.

Para obter mais informações, consulte Configuration Manager SEDO.

Observação

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

Exemplos

Exemplo 1: obter detalhes de bloqueio de objeto para um aplicativo

Este exemplo mostra a saída para os detalhes de bloqueio de um aplicativo.

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

Quando não há bloqueio no objeto, a saída é semelhante, mas muitas das propriedades ficam em branco. Os valores não $nullsão , mas uma cadeia de caracteres ""vazia .

Exemplo 2: verifique se há um bloqueio antes de editar um objeto

Este exemplo usa primeiro o cmdlet Get-CMApplication para obter um objeto de aplicativo. Em seguida, ele usa o cmdlet Get-CMObjectLockDetails para esse aplicativo e atribui a propriedade AssignedUser ao lockUser variável. Se esse valor estiver em branco, ele usará o cmdlet Set-CMApplication para alterar o nome do aplicativo. Se a variável lockUser não estiver em branco, ela gravará um aviso.

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

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique um objeto Configuration Manager que é saída de outro cmdlet. Por exemplo, para obter um objeto de aplicativo, use o cmdlet Get-CMApplication .

Para obter uma lista de objetos habilitados para SEDO, consulte Configuration Manager SEDO.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object