Ações Condicionais do Configuration Manager

As ações do Configuration Manager podem ser exibidas de acordo com as condições especificadas. As condições são definidas da seguinte forma:

  • 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 elementos a seguir especificam uma expressão regular para uma ação:

Elemento Descrição
MatchPattern Especifica o padrão a ser pesquisado.
MatchValueToTest Especifica o valor com o qual comparar. O valor a seguir ##Sub é uma propriedade no objeto selecionado. A propriedade não deve ser preguiçosa e deve existir no objeto select.

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 ser chamado. Se o método retornar true, a ação será mostrada; se o método retornar false, a ação será ocultada.

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 do .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 do .NET Framework, consulte Ação AssemblyType do Configuration Manager.

Permissões de Segurança

Você pode restringir a disponibilidade de uma ação aplicando restrições de segurança ao objeto ou à classe de objeto selecionada.

Permissões de instância de objeto

Você pode restringir a disponibilidade de uma ação aplicando as permissões necessárias ao objeto selecionado. No exemplo XML a seguir, os elementos a seguir especificam as permissões de instância para o objeto selecionado:

Elemento Descrição
InstancePermissions O elemento pai para a 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 de XML a seguir, a Delete ação para um objeto selecionado estará disponível somente 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 de XML a seguir descreve as permissões necessárias para coleções de 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 Values Depende de
Leitura 1 Nenhum
Modificar 2 1
Excluir 4 1
Distribuir 8 1
CreateChild 16 1
Controle Remoto 32 Nenhum
Advertise 64 1
ModifyResource 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
ModifyCollectionSetting 2097152 1
ManageOsdCertificate 4194304 1

Confira também

Configuration Manager ActionsConfigurationManager Ação XMLConfigurationManager AssemblyType ActionConfigurationManager executável ActionConfigurationManager Ação de GrupoAção de Relatório do Configuration Manager AçãoShowDialog do Configuration ManagerComo criar uma ação do Configuration ManagerComo encontrar um GUID de nó do Configuration Manager