azioni condizionali Configuration Manager
Configuration Manager azioni possono essere visualizzate in base alle condizioni specificate. Le condizioni sono definite dalle condizioni seguenti:
Espressioni regolari
Chiamate al metodo
Autorizzazioni di sicurezza
Espressioni regolari
Le espressioni regolari consentono di applicare modelli di ricerca basati su stringhe. Gli elementi seguenti specificano un'espressione regolare per un'azione:
| Elemento | Descrizione |
|---|---|
MatchPattern |
Specifica il modello da cercare. |
MatchValueToTest |
Specifica il valore con cui eseguire il confronto. Il valore seguente ##Sub è una proprietà dell'oggetto selezionato. La proprietà non deve essere differita e deve esistere nell'oggetto select. |
L'azione seguente visualizza una finestra di dialogo ogni volta che il modello specificato (MS_ASYNC_RAS) corrisponde alla proprietà dell'oggetto AddressType selezionato:
<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>
Chiamate al metodo
Un'azione può essere visualizzata a seconda del risultato di una chiamata al metodo. L'elemento ActionDescriptionActionStateAssembly figlio definisce l'assembly, il tipo e il metodo da chiamare. Se il metodo restituisce true, l'azione viene visualizzata; se il metodo restituisce false, l'azione viene nascosta.
Il codice XML seguente chiama un metodo denominato EnableDecrementPriorityMenu nell'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>
Il metodo viene implementato in un assembly .NET Framework con la firma seguente:
public static bool EnableDecrementPriority(object sender, ScopeNode scopeNode, ActionDescription action, ResultObjectBase resultObject)
Per altre informazioni sulla chiamata di metodi in un assembly .NET Framework, vedere Configuration Manager AssemblyType Action.
Autorizzazioni di sicurezza
È possibile limitare la disponibilità di un'azione applicando restrizioni di sicurezza all'oggetto o alla classe oggetto selezionata.
Autorizzazioni dell'istanza dell'oggetto
È possibile limitare la disponibilità di un'azione applicando le autorizzazioni necessarie all'oggetto selezionato. Nell'esempio XML seguente gli elementi seguenti specificano le autorizzazioni di istanza per l'oggetto selezionato:
| Elemento | Descrizione |
|---|---|
InstancePermissions |
Elemento padre dell'elenco delle autorizzazioni dell'istanza. |
SecurityFlagsDetailDescription |
Flag di sicurezza che devono essere impostati per il funzionamento dell'azione. |
Nell'esempio XML seguente l'azione Delete per un oggetto selezionato è disponibile solo se l'utente dispone delle autorizzazioni di modifica:
<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>
Autorizzazioni per le classi di oggetti
È possibile usare l'elemento ClassPermissions per impostare le autorizzazioni della classe oggetto necessarie per un'azione.
ActionSecurityDescription descrive la classe oggetto e le autorizzazioni necessarie per tale classe oggetto. Nell'esempio XML seguente vengono descritte le autorizzazioni necessarie per le raccolte SMS:
<ClassPermissions> <ActionSecurityDescription ClassObject="SMS_Collection" RequiredPermissions="1280" />
</ClassPermissions>
Valori di autorizzazione
I valori di autorizzazione per l'attributo RequiredPermissions sono gli stessi della classe SecurityFlagsDetailDescription e sono i seguenti:
| Autorizzazione | Valori | Dipende |
|---|---|---|
| Lettura | 1 | Nessuno |
| Modifica | 2 | 1 |
| Elimina | 4 | 1 |
| Distribuire | 8 | 1 |
| CreateChild | 16 | 1 |
| RemoteControl | 32 | Nessuno |
| Advertise | 64 | 1 |
| ModifyResource | 128 | 1 |
| Amministrare | 256 | 7 |
| DeleteResource | 512 | 1 |
| Creare | 1024 | Nessuno |
| ViewCollectedFiles | 2048 | 1 |
| ReadResource | 4096 | 1 |
| Delegato | 8192 | Nessuno |
| Metro | 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 |
Vedere anche
azioni Configuration Manager
CONFIGURATION MANAGER Action XML
Configuration Manager'azione AssemblyType
azione eseguibile Configuration Manager
azione gruppo Configuration Manager
azione report Configuration Manager
Configuration Manager'azione ShowDialog
Come creare un'azione di Configuration Manager
Come trovare un GUID del nodo Configuration Manager