Bedingte Aktionen Configuration ManagerConfiguration Manager Conditional Actions

09/20/2016
2 Minuten Lesedauer

Configuration Manager Aktionen können gemäß den angegebenen Bedingungen angezeigt werden.Configuration Manager actions can be displayed according to specified conditions. Die Bedingungen werden wie folgt definiert:The conditions are defined by the following:

Reguläre AusdrückeRegular expressions
MethodenaufrufeMethod calls
SicherheitsberechtigungenSecurity permissions

Reguläre AusdrückeRegular Expressions

Reguläre Ausdrücke ermöglichen das Anwenden von Zeichen folgen basierten Suchmustern.Regular expressions allow you to apply string-based search patterns. Die folgenden Elemente geben einen regulären Ausdruck für eine Aktion an:The following elements specify a regular expression for an action:

ElementElement	BeschreibungDescription
`MatchPattern`	Gibt das zu suchende Muster an.Specifies the pattern to search for.
`MatchValueToTest`	Gibt den Wert an, mit dem verglichen werden soll.Specifies the value to compare against. Der folgende Wert `##Sub` ist eine Eigenschaft für das ausgewählte Objekt.The value following `##Sub` is a property on the selected object. Die-Eigenschaft darf nicht verzögert sein und muss auf dem SELECT-Objekt vorhanden sein.The property must not be lazy and must exist on the select object.

Mit der folgenden Aktion wird ein Dialogfeld angezeigt, wenn das angegebene Muster (MS_ASYNC_RAS) mit der-Eigenschaft des ausgewählten Objekts übereinstimmt AddressType :The following action displays a dialog box whenever the specified pattern (MS_ASYNC_RAS) matches the selected object's AddressType property:

<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>

MethodenaufrufeMethod Calls

Eine Aktion kann abhängig vom Ergebnis eines Methoden Aufrufes angezeigt werden.An action can be shown depending on the result of a method call. Das untergeordnete ActionDescription ActionStateAssembly -Element definiert die Assembly, den Typ und die Methode, die aufgerufen werden sollen.The ActionDescription child element ActionStateAssembly defines the assembly, type, and method to be called. Wenn die-Methode zurückgibt true , wird die-Aktion angezeigt. wenn die Methode zurückgibt false , wird die Aktion ausgeblendet.If the method returns true, the action is shown; if the method returns false, the action is hidden.

Der folgende XML-Code Ruft eine Methode EnableDecrementPriorityMenu mit dem Namen in der Assembly AdminUI.Addresses.dll auf:The following XML calls a method named EnableDecrementPriorityMenu in the assembly 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:The method is implemented in a .NET Framework assembly with the following signature:

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.For more information about calling methods in a .NET Framework assembly, see Configuration Manager AssemblyType Action.

SicherheitsberechtigungenSecurity Permissions

Sie können die Verfügbarkeit einer Aktion einschränken, indem Sie Sicherheitseinschränkungen auf das ausgewählte Objekt oder die Objektklasse anwenden.You can restrict the availability of an action by applying security restrictions to the selected object or object class.

ObjektinstanzberechtigungenObject Instance Permissions

Sie können die Verfügbarkeit einer Aktion einschränken, indem Sie die erforderlichen Berechtigungen für das ausgewählte Objekt anwenden.You can restrict the availability of an action by applying required permissions to the selected object. Im folgenden XML-Beispiel geben die folgenden Elemente die Instanzberechtigungen für das ausgewählte Objekt an:In the following XML example, the following elements specify the instance permissions for the selected object:

ElementElement	BeschreibungDescription
`InstancePermissions`	Das übergeordnete Element der Liste der Instanzberechtigungen.The parent element to the list of instance permissions.
`SecurityFlagsDetailDescription`	Die sicherheitsflags, die festgelegt werden müssen, damit die Aktion funktioniert.The security flags that must be set for the action to work.

Im folgenden XML-Beispiel ist die Delete Aktion für ein ausgewähltes Objekt nur verfügbar, wenn der Benutzer über die Berechtigung "ändern" verfügt:In the following XML example, the Delete action for a selected object is available only if the user has modify permissions:

<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>

Objektklassen BerechtigungenObject Class Permissions

Sie können das- ClassPermissions Element verwenden, um die für eine Aktion erforderlichen Objektklassen Berechtigungen festzulegen.You can use the ClassPermissions element to set the object class permissions required for an action. In " aktionsecuritydescription " werden die Objektklasse und die erforderlichen Berechtigungen für diese Objektklasse beschrieben.ActionSecurityDescription describes the object class and the required permissions for that object class. Im folgenden XML-Beispiel werden die für SMS-Sammlungen erforderlichen Berechtigungen beschrieben:The following XML example describes the permissions required for SMS collections:

<ClassPermissions> <ActionSecurityDescription ClassObject="SMS_Collection" RequiredPermissions="1280" />  
</ClassPermissions>

Berechtigungs WertePermission Values

Die Berechtigungs Werte für das Attribut "Requirements drequirements " sind identisch mit denen für die Klasse " securityflagsdetaildescription " und lauten wie folgt:The permission values for the RequiredPermissions attribute are the same as for the SecurityFlagsDetailDescription class and are as follows:

BerechtigungPermission	WerteValues	Abhängig vonDepends on
LesenRead	11	KeineNone
ÄndernModify	22	11
LöschenDelete	44	11
VerteilenDistribute	88	11
CreateChildCreateChild	1616	11
RemotecontrolRemoteControl	3232	KeineNone
AnkündigenAdvertise	6464	11
ModifyresourceModifyResource	128128	11
VerwaltenAdminister	256256	77
DeleteresourceDeleteResource	512512	11
ErstellenCreate	10241024	KeineNone
ViewcollectedfilesViewCollectedFiles	20482048	11
Ressource lesenReadResource	40964096	11
DelegatDelegate	81928192	KeineNone
ZählerMeter	1638416384	11
ManagesqlcommandManageSqlCommand	3276832768	11
Managestatus FilterManageStatusFilter	6553665536	11
ManagefolderManageFolder	131072131072	11
Network AccessNetworkAccess	262144262144	11
ImportmachineentryImportMachineEntry	524288524288	11
"Kreatemediacertificate"CreateMediaCertificate	10485761048576	11
ModifycollectionsettingModifyCollectionSetting	20971522097152	11
ManageosdcertificateManageOsdCertificate	41943044194304	11

Weitere InformationenSee Also