Freigeben über


Freigeben einer Sperre für ein SEDO-Enabled-Objekt

So geben Sie eine explizite Sperre für ein SEDO-fähiges Objekt frei

  1. Erstellen einer Instanz der WMI-Klasse SMS_ObjectLock

  2. Rufen Sie das Methodenparameterobjekt für die ReleaseLock Methode ab.

  3. Weisen Sie der -Eigenschaft den Objektpfad des Objekts zu, das Sie entsperren ObjectRelPath möchten.

  4. Erstellen Sie eine InvokeMethodOptions Objektinstanz. Fügen Sie in der Context-Eigenschaft ein Name-Wert-Paar hinzu. Der Name muss "MachineName" sein, und der Wert muss der Name des Computers sein, der die Sperre loslässt. Weitere Informationen finden Sie unter Abrufen einer Sperre für ein SEDO-Enabled-Objekt.

  5. Rufen Sie InvokeMethod für die -Instanz auf SMS_ObjectLock .

  6. InvokeMethod gibt eine SMS_ObjectLockRequest -Instanz zurück. Überprüfen Sie die RequestState Eigenschaften und LockState , um weitere Informationen zum Erfolg oder Fehler der Anforderung zu erhalten.

Beispiel

Im folgenden Beispiel wird eine Sperre für eine SMS_ConfigurationItem Objektinstanz freigegeben.

class Program  
{  
    static void Main(string[] args)   
    {  
        ManagementScope scope = new ManagementScope(@"\siteservername\root\sms\site_ABC");  
        ReleaseLock(scope);   
    }  

    public static void ReleaseLock(ManagementScope scope)   
    {  
        ManagementPath path = new ManagementPath("SMS_ObjectLock");  
        ManagementClass objectLock = new ManagementClass(scope, path, null);   

        ManagementBaseObject inParams = objectLock.GetMethodParameters("ReleaseLock");  
        inParams["ObjectRelPath"] = "SMS_ConfigurationItem.CI_ID=30";  

        InvokeMethodOptions options = new InvokeMethodOptions();  
        options.Context.Add("MachineName", "RequestingComputer");   

        ManagementBaseObject result = objectLock.InvokeMethod("ReleaseLock", inParams, options);   

    }  
}  

Das SMS_ObjectLockRequest-Objekt enthält die folgenden Eigenschaften:

Eigenschaft Beschreibung
Requestid Eindeutiger Bezeichner der Anforderung.
ObjectRelPath Der Pfad des Objekts, für das die Sperre angefordert wird.
RequestState Gibt den Erfolg oder Fehler der Anforderung an.
LockState Gibt den aktuellen Zustand der angeforderten Sperre an.
AssignedUser Gibt den aktuell zugewiesenen Benutzer der angeforderten Sperre an.
AssignedObjectLockContext Gibt ObjectLockContext an, dem die Sperre derzeit zugewiesen ist.
AssignedMachine Gibt den aktuell zugewiesenen Computer der angeforderten Sperre an.
AssignedSiteCode Gibt den aktuellen Standort der angeforderten Sperre an.
AssignedTimeUTC Gibt den Zeitpunkt an, zu dem die angeforderte Sperre zugewiesen wurde.

RequestState
In der folgenden Tabelle werden die möglichen Anforderungszustandswerte angezeigt. Die Anforderungszustände Granted, GrantedAfterTimeout und GrantedLockWasOrphaned geben eine erfolgreiche Anforderung an, und der Benutzer kann dann Änderungen am Objekt vornehmen und speichern. Alle anderen Anforderungen weisen auf einen Fehler hin.

RequestStateID RequestStateName
0 Unbekannt
2 Angefordert
3 RequestedCanceled
4 ResponseReceived
10 Gewährt
11 GrantedAfterTimeout
12 GrantedLockWasOrphaned
20 DeniedLockAlreadyAssigned
21 DeniedInvalidObjectVersion
22 DeniedLockNotFound
23 DeniedLockNotLocal
24 DeniedRequestTimedOut
50 Fehler
52 ErrorRequestNotFound
53 ErrorRequestTimedOut

LockState
In der folgenden Tabelle werden die möglichen Werte für den Sperrzustand angezeigt.

LockStateID LockStateName
0 Nicht zugewiesen
1 Zugewiesen
2 Angefordert
3 PendingAssignment
4 Timedout
5 NotFound

Kompilieren des Codes

Für das C#-Beispiel ist Folgendes erforderlich:

Namespaces

System

System.Management

Assembly

Robuste Programmierung

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager Fehlern.

Siehe auch

Configuration Manager SEDO