Configuration Manager bedingte Aktionen
Configuration Manager Aktionen können gemäß den angegebenen Bedingungen angezeigt werden. Die Bedingungen werden wie folgt definiert:
Reguläre Ausdrücke
Methodenaufrufe
Sicherheitsberechtigungen
Reguläre Ausdrücke
Mit regulären Ausdrücken können Sie zeichenfolgenbasierte Suchmuster anwenden. Die folgenden Elemente geben einen regulären Ausdruck für eine Aktion an:
Element | Beschreibung |
---|---|
MatchPattern |
Gibt das muster an, nach dem gesucht werden soll. |
MatchValueToTest |
Gibt den Wert an, mit dem verglichen werden soll. Der folgende ##Sub Wert ist eine Eigenschaft für das ausgewählte Objekt. Die Eigenschaft darf nicht verzögert sein und muss für das ausgewählte Objekt vorhanden sein. |
Die folgende Aktion zeigt ein Dialogfeld an, wenn das angegebene Muster (MS_ASYNC_RAS) mit der Eigenschaft des AddressType
ausgewählten Objekts übereinstimmt:
<ActionDescription ActionVerb="Properties" Class="ShowDialog"> <ShowOn> <string>DefaultContextualTab</string> <!-- Show on Ribbon --> <string>ContextMenu</string> <!-- Show on Context Menu --> </ShowOn> <MatchPattern>MS_ASYNC_RAS</MatchPattern>
<MatchValueToTest>##SUB:AddressType##</MatchValueToTest>
<DialogId>AsyncRasSenderAddress</DialogId></ActionDescription>
Methodenaufrufe
Eine Aktion kann abhängig vom Ergebnis eines Methodenaufrufs angezeigt werden. Das ActionDescription
untergeordnete Element ActionStateAssembly
definiert die Assembly, den Typ und die Methode, die aufgerufen werden soll. Wenn die Methode zurückgibt true
, wird die Aktion angezeigt. Wenn die Methode zurückgibt false
, wird die Aktion ausgeblendet.
Der folgende XML-Code ruft eine Methode namens EnableDecrementPriorityMenu
in der Assembly AdminUI.Addresses.dll auf:
<ActionDescription>
<ShowOn>
<string>DefaultContextualTab</string> <!-- Show on Ribbon --> <string>ContextMenu</string><!-- Show on Context Menu --> </ShowOn> <ActionStateAssembly>
<Assembly>AdminUI.Addresses.dll</Assembly> <Type>Microsoft.ConfigurationManagement.AdminConsole.Addresses.AddressUtilityClass</Type>
<Method>EnableDecrementPriorityMenu</Method> </ActionStateAssembly>
</ActionDescription>
Die -Methode wird in einer .NET Framework-Assembly mit der folgenden Signatur implementiert:
public static bool EnableDecrementPriority(object sender, ScopeNode scopeNode, ActionDescription action, ResultObjectBase resultObject)
Weitere Informationen zum Aufrufen von Methoden in einer .NET Framework Assembly finden Sie unter Configuration Manager AssemblyType-Aktion.
Sicherheitsberechtigungen
Sie können die Verfügbarkeit einer Aktion einschränken, indem Sie Sicherheitseinschränkungen auf das ausgewählte Objekt oder die objektklasse anwenden.
Objektinstanzberechtigungen
Sie können die Verfügbarkeit einer Aktion einschränken, indem Sie die erforderlichen Berechtigungen auf das ausgewählte Objekt anwenden. Im folgenden XML-Beispiel geben die folgenden Elemente die Instanzberechtigungen für das ausgewählte Objekt an:
Element | Beschreibung |
---|---|
InstancePermissions |
Das übergeordnete Element der Liste der Instanzberechtigungen. |
SecurityFlagsDetailDescription |
Die Sicherheitsflags, die festgelegt werden müssen, damit die Aktion funktioniert. |
Im folgenden XML-Beispiel ist die Delete
Aktion für ein ausgewähltes Objekt nur verfügbar, wenn der Benutzer über Änderungsberechtigungen verfügt:
<ActionDescription ActionVerb="Delete" Class="Default" SelectionMode="Both" InstanceDependsOn="SMS_Site">
<ShowOn> <string>DefaultContextualTab</string> <!-- Show on Ribbon --> <string>ContextMenu</string> <!-- Show on Context Menu --></ShowOn><InstancePermissions><SecurityFlagsDetailDescription BitName="Modify" BitValue="2" DependsOn="1" /></InstancePermissions>
</ActionDescription>
Objektklassenberechtigungen
Sie können das ClassPermissions
-Element verwenden, um die für eine Aktion erforderlichen Objektklassenberechtigungen festzulegen.
ActionSecurityDescription beschreibt die Objektklasse und die erforderlichen Berechtigungen für diese Objektklasse. Im folgenden XML-Beispiel werden die berechtigungen beschrieben, die für SMS-Sammlungen erforderlich sind:
<ClassPermissions> <ActionSecurityDescription ClassObject="SMS_Collection" RequiredPermissions="1280" />
</ClassPermissions>
Berechtigungswerte
Die Berechtigungswerte für das RequiredPermissions-Attribut sind identisch mit denen für die SecurityFlagsDetailDescription-Klasse und sind wie folgt:
Berechtigung | Werte | Hängt |
---|---|---|
Lesen | 1 | Keinen |
Ändern | 2 | 1 |
Löschen | 4 | 1 |
Verteilen | 8 | 1 |
CreateChild | 16 | 1 |
RemoteControl | 32 | Keine |
Advertise | 64 | 1 |
ModifyResource | 128 | 1 |
Verwalten | 256 | 7 |
DeleteResource | 512 | 1 |
Erstellen | 1024 | Keine |
ViewCollectedFiles | 2048 | 1 |
ReadResource | 4096 | 1 |
Stellvertretung | 8192 | Keine |
Verbrauchseinheit | 16384 | 1 |
ManageSqlCommand | 32768 | 1 |
ManageStatusFilter | 65536 | 1 |
ManageFolder | 131072 | 1 |
Networkaccess | 262144 | 1 |
ImportMachineEntry | 524288 | 1 |
CreateMediaCertificate | 1048576 | 1 |
ModifyCollectionSetting | 2097152 | 1 |
ManageOsdCertificate | 4194304 | 1 |
Siehe auch
Configuration Manager Aktionen
Configuration Manager-Aktions-XML
Configuration Manager AssemblyType-Aktion
Configuration Manager Ausführbare Aktion
Configuration Manager-Gruppenaktion
Configuration Manager-Berichtsaktion
Configuration Manager ShowDialog-Aktion
Erstellen einer Configuration Manager Aktion
Suchen einer Configuration Manager Knoten-GUID