Get-CMObjectLockDetails

  • 參考
模組:
ConfigurationManager

取得物件的 SEDO 鎖定詳細資料。

Syntax

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

Description

使用此 Cmdlet 取得物件的 SEDO 鎖定詳細資料。 Configuration Manager SEDO (分散式物件的序列化編輯) 是將鎖定指派給全域複寫物件的機制。 如果使用者想要編輯並儲存物件，他們必須從網站取得鎖定。 月臺會為該物件、其電腦和網站中的使用者指派鎖定。 當使用者擁有鎖定時，沒有其他人可以編輯物件。

如需詳細資訊，請參閱 Configuration Manager SEDO。

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 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 Cmdlet 來取得應用程式物件。 然後，它會針對該應用程式使用 Get-CMObjectLockDetails Cmdlet，並將 AssignedUser 屬性指派給變數 lockUser。 如果該值為空白，則會使用 Set-CMApplication Cmdlet 來變更應用程式的名稱。 如果 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

指定從另一個 Cmdlet 輸出的Configuration Manager物件。 例如，若要取得應用程式物件，請使用 Get-CMApplication Cmdlet。

如需已啟用 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