Voorwaardelijke acties in Configuration Manager

Configuration Manager-acties kunnen worden weergegeven op basis van opgegeven voorwaarden. De voorwaarden worden gedefinieerd door het volgende:

  • Reguliere expressies

  • Methode aanroepen

  • Machtigingen voor beveiliging

Reguliere expressies

Met reguliere expressies kunt u zoekpatronen toepassen op basis van tekenreeksen. Met de volgende elementen wordt een reguliere expressie voor een actie aangegeven:

Element Beschrijving
MatchPattern Hiermee geeft u het patroon op dat u zoekt.
MatchValueToTest Hiermee geeft u de waarde op waarmee u wilt vergelijken. De volgende ##Sub waarde is een eigenschap voor het geselecteerde object. De eigenschap mag niet lui zijn en moet bestaan in het geselecteerde object.

Met de volgende actie wordt een dialoogvenster weergegeven wanneer het opgegeven patroon (MS_ASYNC_RAS) overeenkomt met de eigenschap van AddressType het geselecteerde object:

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

Method Calls

Een actie kan worden weergegeven afhankelijk van het resultaat van een methodeaanroep. Het ActionDescription onderliggende element ActionStateAssembly definieert de assembly, het type en de methode die moet worden aangeroepen. Als de methode als resultaat geeft true, wordt de actie weergegeven; als het resultaat van de methode is false, wordt de actie verborgen.

De volgende XML-aanroep een methode aan die in de assembly-AdminUI.Addresses.dll wordt genoemd EnableDecrementPriorityMenu :

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

De methode wordt geïmplementeerd in een .NET Framework-assembly met de volgende handtekening:

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

Zie de actie AssemblyType van Configuration Manager voor meer informatie over aanroepmethoden in een .NET Framework-assembly.

Machtigingen voor beveiliging

U kunt de beschikbaarheid van een actie beperken door beveiligingsbeperkingen toe te passen op het geselecteerde object of de geselecteerde objectklasse.

Machtigingen voor objectinstantie

U kunt de beschikbaarheid van een actie beperken door de vereiste machtigingen op het geselecteerde object toe te passen. In het volgende XML-voorbeeld geven de volgende elementen de instantiemachtigingen aan voor het geselecteerde object:

Element Beschrijving
InstancePermissions Het bovenliggende element van de lijst met exemplaarmachtigingen.
SecurityFlagsDetailDescription De beveiligingsvlaggen die moeten worden ingesteld om de actie te laten werken.

In het volgende XML-voorbeeld is de Delete actie voor een geselecteerd object alleen beschikbaar als de gebruiker over wijzigingsmachtigingen beschikt:

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

Machtigingen van objectklasse

U kunt het ClassPermissions element gebruiken om de objectklassemachtigingen in te stellen die vereist zijn voor een actie. In ActionSecurityDescription wordt de objectklasse en de vereiste machtigingen voor deze objectklasse beschreven. In het volgende XML-voorbeeld worden de vereiste machtigingen voor SMS-verzamelingen beschreven:

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

Waarden voor machtigingen

De machtigingswaarden voor het kenmerk RequiredPermissions zijn dezelfde als voor de klasse SecurityFlagsDetailDescription en zijn als volgt:

Machtiging Waarden Hangt af van
Lezen 1 Geen
Wijzigen 2 1
Verwijderen 4 1
Distribueren 8 1
CreateChild 16 1
Afstandsbediening 32 Geen
Adverteren 64 1
ModifyResource 128 1
Beheren 256 7
DeleteResource 512 1
Maken 1024 Geen
ViewCollectedFiles 2048 1
ReadResource 4096 1
Gemachtigde 8192 Geen
Meter 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

Zie ook

Configuration Manager ActiesConfiguration Manager Actie XML Configuration Manager AssemblyType-actieConfiguration Manager Uitvoerbare actieConfiguration Manager GroepsactieConfiguration Manager RapportactieConfiguration Manager DialogWeergeven, actieEen Configuration Manager-actiemaken Een Configuration Manager knooppunt-GUID zoeken

  • Last updated on