Get-CMObjectLockDetails

  • リファレンス
モジュール:
ConfigurationManager

オブジェクトの SEDO ロックの詳細を取得します。

構文

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

説明

オブジェクトの SEDO ロックの詳細を取得するには、このコマンドレットを使用します。 Configuration Manager SEDO (分散オブジェクトのシリアル化された編集) は、グローバルにレプリケートされたオブジェクトにロックを割り当てるメカニズムです。 ユーザーがオブジェクトを編集して保存する場合は、サイトからロックを取得する必要があります。 サイトは、そのオブジェクト、コンピューター、およびサイトのユーザーにロックを割り当てます。 ユーザーはロックを持ちますが、他のユーザーはオブジェクトを編集できません。

詳細については、「Configuration Manager SEDO」を参照してください。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: アプリケーションのオブジェクト ロックの詳細を取得する

この例では、アプリケーションのロックの詳細の出力を示します。

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

オブジェクトにロックがない場合、出力は似ていますが、プロパティの多くは空白です。 値は ではなく $null、空の文字列 ""です。

例 2: オブジェクトを編集する前にロックを確認する

この例では、まず Get-CMApplication コマンドレットを使用してアプリ オブジェクトを取得します。 その後、そのアプリの Get-CMObjectLockDetails コマンドレットを使用し、 AssignedUser プロパティを変数 lockUser に割り当てます。 この値が空白の場合は、 Set-CMApplication コマンドレットを使用してアプリの名前を変更します。 lockUser 変数が空白でない場合は、警告が書き込まれます。

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

パラメーター

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-InputObject

別のコマンドレットから出力されるConfiguration Manager オブジェクトを指定します。 たとえば、アプリケーション オブジェクトを取得するには、 Get-CMApplication コマンドレットを 使用します。

SEDO が有効なオブジェクトの一覧については、「Configuration Manager SEDO」を参照してください。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object