Configuration Manager actions conditionnelles

Configuration Manager actions peuvent être affichées en fonction des conditions spécifiées. Les conditions sont définies par les éléments suivants :

• Expressions régulières

• Appels de méthode

• Autorisations de sécurité

Expressions régulières

Les expressions régulières vous permettent d’appliquer des modèles de recherche basés sur des chaînes. Les éléments suivants spécifient une expression régulière pour une action :

L’action suivante affiche une boîte de dialogue chaque fois que le modèle spécifié (MS_ASYNC_RAS) correspond à la propriété de l’objet AddressType sélectionné :

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

Appels de méthode

Une action peut être affichée en fonction du résultat d’un appel de méthode. L’élément ActionDescriptionActionStateAssembly enfant définit l’assembly, le type et la méthode à appeler. Si la méthode retourne true, l’action est affichée ; si la méthode retourne false, l’action est masquée.

Le code XML suivant appelle une méthode nommée EnableDecrementPriorityMenu dans l’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>  

La méthode est implémentée dans un assembly .NET Framework avec la signature suivante :

public static bool EnableDecrementPriority(object sender, ScopeNode scopeNode, ActionDescription action, ResultObjectBase resultObject)

Pour plus d’informations sur l’appel de méthodes dans un assembly .NET Framework, consultez Configuration Manager’action AssemblyType.

Autorisations de sécurité

Vous pouvez restreindre la disponibilité d’une action en appliquant des restrictions de sécurité à l’objet ou à la classe d’objet sélectionné.

Autorisations d’instance d’objet

Vous pouvez restreindre la disponibilité d’une action en appliquant les autorisations requises à l’objet sélectionné. Dans l’exemple XML suivant, les éléments suivants spécifient les autorisations d’instance pour l’objet sélectionné :

Dans l’exemple XML suivant, l’action Delete d’un objet sélectionné est disponible uniquement si l’utilisateur dispose d’autorisations de modification :

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

Autorisations de classe d’objet

Vous pouvez utiliser l’élément ClassPermissions pour définir les autorisations de classe d’objet requises pour une action. ActionSecurityDescription décrit la classe d’objet et les autorisations requises pour cette classe d’objet. L’exemple XML suivant décrit les autorisations requises pour les collections SMS :

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

Valeurs d’autorisation

Les valeurs d’autorisation de l’attribut RequiredPermissions sont les mêmes que pour la classe SecurityFlagsDetailDescription et sont les suivantes :

Voir aussi

actions Configuration Manager
XML d’action Configuration Manager
action AssemblyType Configuration Manager
action exécutable Configuration Manager
action de groupe Configuration Manager
action de rapport Configuration Manager
Configuration Manager ShowDialog Action
Guide pratique pour créer une action Configuration Manager
Guide pratique pour rechercher un GUID de nœud Configuration Manager