Configuration Manager bedingte Aktionen

Artikel
04/04/2023

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

Teilen über