Configuration Manager des 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 une chaîne. Les éléments suivants spécifient une expression régulière pour une action :

Élément Description
MatchPattern Spécifie le modèle à rechercher.
MatchValueToTest Spécifie la valeur par rapport à laquelle effectuer la comparaison. La valeur suivante ##Sub est une propriété sur l’objet sélectionné. La propriété ne doit pas être différée et doit exister sur l’objet Select.

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 sélectionné AddressType :

<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' ActionDescription élément enfant ActionStateAssembly 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 des 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’objets sélectionnés.

Autorisations de l’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é :

Élément Description
InstancePermissions Élément parent de la liste des autorisations d’instance.
SecurityFlagsDetailDescription Indicateurs de sécurité qui doivent être définis pour que l’action fonctionne.

Dans l’exemple XML suivant, l' Delete action d’un objet sélectionné n’est disponible que si l’utilisateur dispose des autorisations modifier :

<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 la classe Object

Vous pouvez utiliser l' ClassPermissions élément 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 de code 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 celles de la classe SecurityFlagsDetailDescription et sont les suivantes :

Autorisation Valeurs Dépend de
Lire 1 None
Modifier 2 1
Supprimer 4 1
Distribuer 8 1
CreateChild 16 1
RemoteControl 32 None
Publication 64 1
ModifyResource 128 1
Administrer 256 7
DeleteResource 512 1
Créer 1 024 None
ViewCollectedFiles 2 048 1
Lire la ressource 4096 1
Délégué 8 192 None
Compteur 16384 1
ManageSqlCommand 32 768 1
ManageStatusFilter 65536 1
ManageFolder 131 072 1
NetworkAccess 262 144 1
ImportMachineEntry 524 288 1
CreateMediaCertificate 1 048 576 1
ModifyCollectionSetting 2 097 152 1
ManageOsdCertificate 4 194 304 1

Voir aussi

Actions Configuration Manager
XML d’action Configuration Manager
Action Configuration Manager AssemblyType
Action Configuration Manager exécutable
Action du groupe de Configuration Manager
Action de rapport Configuration Manager
Action ShowDialog Configuration Manager
Comment créer une action Configuration Manager
Recherche d’un GUID de nœud Configuration Manager