Bedingte Configuration Manager-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 auf Zeichenfolgenbasis basierende 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 zu vergleichenden Wert an. Der folgende ##Sub Wert ist eine Eigenschaft für das ausgewählte Objekt. Die Eigenschaft darf nicht träge 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 ausgewählten Objekts AddressType ü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 aufzurufende Methode. Wenn die Methode zurückgibt true, wird die Aktion angezeigt; wenn die Methode zurückkehrt false, wird die Aktion ausgeblendet.

Der folgende XML-Code ruft eine Methode EnableDecrementPriorityMenu auf, die in der Assembly benannt AdminUI.Addresses.dll:

<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 ausgewählte Objektklasse anwenden.

Berechtigungen für Objektinstanzen

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 instance Berechtigungen für das ausgewählte Objekt an:

Element Beschreibung
InstancePermissions Das übergeordnete Element zur Liste der instance-Berechtigungen.
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>

Berechtigungen für Objektklassen

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 mit denen für die SecurityFlagsDetailDescription-Klasse identisch und lauten wie folgt:

Permission Werte Hängt von
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
Ordner verwalten 131072 1
NetworkAccess 262144 1
ImportMachineEntry 524288 1
CreateMediaCertificate 1048576 1
ModifyCollectionSetting 2097152 1
ManageOsdCertificate 4194304 1

Siehe auch

Configuration Manager ActionsConfiguration Manager Action XML Configuration Manager AssemblyType ActionConfiguration Manager Executable ActionConfiguration Manager GruppenaktionConfiguration Manager Aktion meldenConfiguration Manager ShowDialog-AktionErstellen einer Configuration Manager AktionSo finden Sie eine Configuration Manager Knoten-GUID