Villkorsstyrda åtgärder i Configuration Manager

Configuration Manager åtgärder kan visas enligt angivna villkor. Villkoren definieras av följande:

  • Reguljära uttryck

  • Metodanrop

  • Säkerhetsbehörigheter

Reguljära uttryck

Med reguljära uttryck kan du använda strängbaserade sökmönster. Följande element anger ett reguljärt uttryck för en åtgärd:

Element Beskrivning
MatchPattern Anger det mönster som ska sökas efter.
MatchValueToTest Anger det värde som du vill jämföra med. Värdet som följer ##Sub är en egenskap för det valda objektet. Egenskapen får inte ligga på latsidan och måste finnas på det markerade objektet.

Följande åtgärd visar en dialogruta när det angivna mönstret (MS_ASYNC_RAS) matchar det markerade objektets AddressType egenskap:

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

Metodanrop

En åtgärd kan visas beroende på resultatet av ett metodanrop. Det underordnade ActionDescription elementet ActionStateAssembly definierar sammansättningen, typen och metoden som ska anropas. Om metoden returnerar truevisas åtgärden. Om metoden returnerar falseär åtgärden dold.

Följande XML anropar en metod som namnges EnableDecrementPriorityMenu i sammansättningsAdminUI.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>

Metoden implementeras i en .NET Framework sammansättning med följande signatur:

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

Mer information om hur du anropar metoder i en .NET Framework sammansättning finns i Configuration Manager AssemblyType Action.

Säkerhetsbehörigheter

Du kan begränsa tillgängligheten för en åtgärd genom att tillämpa säkerhetsbegränsningar på det markerade objektet eller objektklassen.

Behörigheter för objektinstanser

Du kan begränsa tillgängligheten för en åtgärd genom att tillämpa den behörighet som krävs på det markerade objektet. I följande XML-exempel anger följande element instansbehörigheterna för det markerade objektet:

Element Beskrivning
InstancePermissions Det överordnade elementet i listan över instansbehörigheter.
SecurityFlagsDetailDescription De säkerhetsflaggor som måste anges för att åtgärden ska fungera.

I följande XML-exempel Delete är åtgärden för ett markerat objekt endast tillgänglig om användaren har behörighet att ändra:

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

Behörigheter för objektklass

Du kan använda elementet ClassPermissions för att ange de objektklassbehörigheter som krävs för en åtgärd. ActionSecurityDescription beskriver objektklassen och de behörigheter som krävs för den objektklassen. I följande XML-exempel beskrivs de behörigheter som krävs för SMS-samlingar:

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

Behörighetsvärden

Behörighetsvärdena för attributet RequiredPermissions är samma som för klassen SecurityFlagsDetailDescription och är följande:

Behörighet Värden Beror på
Läsa 1 Inga
Ändra 2 1
Radera 4 1
Distribuera 8 1
CreateChild 16 1
Fjärrkontroll 32 Inga
Annonsera 64 1
ModifyResource 128 1
Administrera 256 7
Ta bortResource 512 1
Skapa 1024 Inga
ViewCollectedFiles (visa insamlade filer) 2048 1
ReadResource (ReadResource) 4096 1
Ombud 8192 Inga
Mätare 16384 1
ManageSqlCommand 32768 1
ManageStatusFilter 65536 1
ManageFolder 131072 1
NetworkAccess 262144 1
ImportMachineEntry (ImportMachineEntry) 524288 1
CreateMediaCertificate (på engelska) 1048576 1
ModifyCollectionSetting 2097152 1
ManageOsdCertificate 4194304 1

Se även

Configuration ManagerÅtgärderConfiguration Manager Åtgärd XMLConfiguration Manager AssemblyType ÅtgärdConfigurationManager Körbar åtgärdConfigurationManager GruppåtgärdConfigurationManager rapportåtgärdConfigurationManager ShowDialog-åtgärdSkapa en Configuration Manager -åtgärdHitta en nod-GUID för Configuration Manager