Get-CMObjectLockDetails
取得物件的 SEDO 鎖定詳細數據。
語法
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 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定從另一個 Cmdlet 輸出的 Configuration Manager 物件。 例如,若要取得應用程式物件,請使用 Get-CMApplication Cmdlet。
如需已啟用 SEDO 的物件清單,請參閱 Configuration Manager SEDO。
類型: | IResultObject |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object