Get-CMObjectLockDetails

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

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

構文

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

説明

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

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

注意

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

例

例 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 コマンドレットを使用し 、AssignUser プロパティを変数 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
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

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

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object