Get-CMObjectLockDetails

  • Referência
Módulo:
ConfigurationManager

Obtenha os detalhes de um bloqueio SEDO para um objeto.

Sintaxe

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

Description

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

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

Observação

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

Exemplos

Exemplo 1: Obter detalhes de bloqueio de objetos para uma aplicação

Este exemplo mostra a saída para os detalhes de bloqueio de uma aplicação.

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 existe nenhum bloqueio no objeto, o resultado é semelhante, mas muitas das propriedades estão em branco. Os valores não $nullsão , mas sim uma cadeia ""vazia.

Exemplo 2: Verificar a existência de um bloqueio antes de editar um objeto

Este exemplo utiliza primeiro o cmdlet Get-CMApplication para obter um objeto de aplicação. Em seguida, utiliza o cmdlet Get-CMObjectLockDetails para essa aplicação e atribui a propriedade AssignedUser ao lockUser variável. Se esse valor estiver em branco, utilizará o cmdlet Set-CMApplication para alterar o nome da aplicação. Se a variável lockUser não estiver em branco, escreve 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

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto do Configuration Manager que seja o resultado de outro cmdlet. Por exemplo, para obter um objeto de aplicação, utilize o cmdlet Get-CMApplication .

Para obter uma lista de objetos ativados para SEDO, veja SEDO do Configuration Manager.

Tipo:IResultObject
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object