ações condicionais Configuration Manager
Configuration Manager ações podem ser exibidas de acordo com as condições especificadas. As condições são definidas pelo seguinte:
Expressões regulares
Chamadas de método
Permissões de segurança
Expressões Regulares
Expressões regulares permitem aplicar padrões de pesquisa baseados em cadeia de caracteres. Os seguintes elementos especificam uma expressão regular para uma ação:
| Elemento | Descrição |
|---|---|
MatchPattern |
Especifica o padrão a ser pesquisado. |
MatchValueToTest |
Especifica o valor a ser comparado. O valor a seguir ##Sub é uma propriedade no objeto selecionado. A propriedade não deve ser preguiçosa e deve existir no objeto selecionado. |
A ação a seguir exibe uma caixa de diálogo sempre que o padrão especificado (MS_ASYNC_RAS) corresponde à propriedade do AddressType objeto selecionado:
<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>
Chamadas de método
Uma ação pode ser mostrada dependendo do resultado de uma chamada de método. O ActionDescription elemento ActionStateAssembly filho define o assembly, o tipo e o método a serem chamados. Se o método retornar true, a ação será mostrada; se o método retornar false, a ação ficará oculta.
O XML a seguir chama um método nomeado EnableDecrementPriorityMenu no 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>
O método é implementado em um assembly .NET Framework com a seguinte assinatura:
public static bool EnableDecrementPriority(object sender, ScopeNode scopeNode, ActionDescription action, ResultObjectBase resultObject)
Para obter mais informações sobre métodos de chamada em um assembly .NET Framework, consulte Configuration Manager AssemblyType Action.
Permissões de segurança
Você pode restringir a disponibilidade de uma ação aplicando restrições de segurança à classe de objeto ou objeto selecionado.
Permissões de instância de objeto
Você pode restringir a disponibilidade de uma ação aplicando permissões necessárias ao objeto selecionado. No exemplo XML a seguir, os seguintes elementos especificam as permissões de instância para o objeto selecionado:
| Elemento | Descrição |
|---|---|
InstancePermissions |
O elemento pai da lista de permissões de instância. |
SecurityFlagsDetailDescription |
Os sinalizadores de segurança que devem ser definidos para que a ação funcione. |
No exemplo XML a seguir, a ação Delete para um objeto selecionado só estará disponível se o usuário tiver permissões de modificação:
<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>
Permissões de classe de objeto
Você pode usar o ClassPermissions elemento para definir as permissões de classe de objeto necessárias para uma ação.
ActionSecurityDescription descreve a classe de objeto e as permissões necessárias para essa classe de objeto. O exemplo XML a seguir descreve as permissões necessárias para coleções SMS:
<ClassPermissions> <ActionSecurityDescription ClassObject="SMS_Collection" RequiredPermissions="1280" />
</ClassPermissions>
Valores de permissão
Os valores de permissão para o atributo RequiredPermissions são os mesmos da classe SecurityFlagsDetailDescription e são os seguintes:
| Permissão | Valores | Depende |
|---|---|---|
| Ler | 1 | Nenhum |
| Modificar | 2 | 1 |
| Excluir | 4 | 1 |
| Distribuir | 8 | 1 |
| CreateChild | 16 | 1 |
| Remotecontrol | 32 | Nenhum |
| Advertise | 64 | 1 |
| ModifiResource | 128 | 1 |
| Administrar | 256 | 7 |
| DeleteResource | 512 | 1 |
| Create | 1024 | Nenhum |
| ViewCollectedFiles | 2048 | 1 |
| ReadResource | 4096 | 1 |
| Delegar | 8192 | Nenhum |
| Medidor | 16384 | 1 |
| ManageSqlCommand | 32768 | 1 |
| ManageStatusFilter | 65536 | 1 |
| ManageFolder | 131072 | 1 |
| Networkaccess | 262144 | 1 |
| ImportMachineEntry | 524288 | 1 |
| CreateMediaCertificate | 1048576 | 1 |
| ModifiCollectionSetting | 2097152 | 1 |
| ManageOsdCertificate | 4194304 | 1 |
Confira também
Ações Configuration Manager
Configuration Manager Action XML
Configuration Manager AssemblyType Action
Configuration Manager ação executável
Configuration Manager ação de grupo
Configuration Manager Ação de Relatório
Configuration Manager ação ShowDialog
Como criar uma ação de Configuration Manager
Como encontrar um GUID de nó Configuration Manager