Voorwaardelijke acties Configuration Manager

Artikel
04/04/2023

Configuration Manager acties kunnen worden weergegeven volgens de opgegeven voorwaarden. De voorwaarden worden als volgt gedefinieerd:

Reguliere expressies
Methode-aanroepen
Beveiligingsmachtigingen

Reguliere expressies

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

Element	Beschrijving
`MatchPattern`	Hiermee geeft u het patroon op dat moet worden gezocht.
`MatchValueToTest`	Hiermee geeft u de waarde op waarmee moet worden vergeleken. 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>

Methode-aanroepen

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 moeten worden aangeroepen. Als de methode retourneert true, wordt de actie weergegeven. Als de methode retourneert false, wordt de actie verborgen.

Met de volgende XML wordt een methode aangeroepen met de naam EnableDecrementPriorityMenu in de 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>

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 Configuration Manager AssemblyType Action voor meer informatie over het aanroepen van methoden in een .NET Framework assembly.

Beveiligingsmachtigingen

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

Machtigingen voor objectexemplaren

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

Element	Beschrijving
`InstancePermissions`	Het bovenliggende element van de lijst met instantiemachtigingen.
`SecurityFlagsDetailDescription`	De beveiligingsvlagmen 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 voor objectklasse

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

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

Machtigingswaarden

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

Machtiging	Waarden	Afhankelijk
Lezen	1	Geen
Wijzigen	2	1
Verwijderen	4	1
Distribueren	8	1
CreateChild	16	1
RemoteControl	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 acties
CONFIGURATION MANAGER Actie-XML
actie AssemblyType Configuration Manager
Uitvoerbare actie Configuration Manager
actie Configuration Manager groep
Configuration Manager rapportactie
Configuration Manager Actie Dialog weergeven
Een Configuration Manager-actie maken
Een Configuration Manager knooppunt-GUID zoeken

Delen via