Alterar uma entrada de função para uma função de nível superior sem escopo
Aplica-se a: Exchange Server 2013
As entradas de função de gerenciamento em funções de gerenciamento de nível superior sem escopo se referem aos scripts e cmdlets não-Exchange e seus parâmetros que você pretende disponibilizar aos atribuídos à função. Ao alterar os parâmetros disponíveis em uma entrada de função, você controla qual dos atribuídos à função podem ser disponibilizados com o script ou o cmdlet não-Exchange. Para obter mais informações sobre entradas de função nãocopadas, consulte Noções básicas sobre funções de gerenciamento.
Observação
Se você quiser alterar uma entrada de função em uma função de gerenciamento que contenha cmdlets do Exchange, consulte Alterar uma entrada de função.
Procurando outras tarefas de gerenciamento relacionadas a funções? Consulte Permissões avançadas.
Do que você precisa saber para começar?
Tempo estimado para concluir cada procedimento: 5 minutos
Para executar este procedimento ou estes procedimentos, você precisa receber permissões. Para ver de que permissões você precisa, consulte o Entrada "funções de gerenciamento" no tópico Permissões de gerenciamento de função.
Você deve usar o Shell para executar estes procedimentos.
A capacidade de alterar uma entrada de função a uma função de nível superior sem escopo não está incluída em nenhum grupo de funções de gerenciamento por padrão. É preciso primeiro atribuir a função de Gerenciamento de Função sem Escopo a um usuário ou a um grupo de funções ou USG de que o usuário seja membro, antes de o usuário poder adicionar ou alterar uma entrada de função de nível superior sem escopo. Para mais informações sobre como adicionar uma função a um usuário, USG ou grupo de função, consulte os seguintes tópicos:
Para informações sobre atalhos de teclado que possam se aplicar aos procedimentos neste tópico, confira Atalhos de teclado no Centro de Administração do Exchange.
Dica
Está com problemas? Peça ajuda nos fóruns do Exchange. Visite os fóruns no Exchange Server.
Usar o Shell Para adicionar um ou mais parâmetros a uma entrada de função
Para adicionar parâmetros a uma entrada de função de nível superior, é preciso proceder da seguinte forma:
Especifique os parâmetros que você deseja adicionar usando o parâmetro Parâmetros .
Especifique o parâmetro AddParameter para indicar que você deseja executar uma operação de adição.
Especifique o parâmetro UnscopedTopLevel para indicar que você está alterando uma entrada de função em uma função de nível superior nãocopada. Se você não especificar esse parâmetro quando alterar uma entrada de função em uma função sem escopo, ocorre um erro.
Para adicionar parâmetros a uma entrada de função, use a sintaxe a seguir.
Set-ManagementRoleEntry <role name>\<script or non-Exchange cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -AddParameter -UnscopedTopLevel
Este exemplo adiciona os parâmetros EmailAddress e City ao script CreateUsers.ps1 na função não copiada Administradores de Destinatários.
Set-ManagementRoleEntry "Recipient Administrators\CreateUsers.ps1" -Parameters EmailAddress, City -AddParameter -UnscopedTopLevel
Para obter informações detalhadas de sintaxe e parâmetro, consulte Set-ManagementRoleEntry.
Usar o Shell para remover um ou mais parâmetros de uma entrada de função
Para remover parâmetros de uma entrada de função, é necessário proceder da seguinte forma:
Especifique os parâmetros que você deseja remover usando o parâmetro Parâmetros .
Especifique o parâmetro RemoveParameter para indicar que você deseja executar uma operação de remoção.
Especifique o parâmetro UnscopedTopLevel para indicar que você está alterando uma entrada de função em uma função de nível superior nãocopada. Se você não especificar esse parâmetro quando alterar uma entrada de função em uma função sem escopo, ocorre um erro.
Aviso
As operações de remoção não podem ser desfeitas. Se você tiver removido por engano um parâmetro de uma entrada de função, será preciso adicioná-lo manualmente outra vez.
Para remover parâmetros de uma entrada de função, use a sintaxe a seguir.
Set-ManagementRoleEntry <role name>\<script or non-Exchange cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -RemoveParameter -UnscopedTopLevel
Este exemplo remove os parâmetros Delay, Force e Credential do cmdlet Start-Widget non-Exchange na função Administradores do Servidor de Camada 1.
Set-ManagementRoleEntry "Tier 1 Server Administrators\Start-Widget" -Parameters Delay, Force, Credential -RemoveParameter -UnscopedTopLevel
Para obter informações detalhadas de sintaxe e parâmetro, consulte Set-ManagementRoleEntry.
Usar o Shell para remover todos os parâmetros de uma entrada de função
Para remover todos os parâmetros de uma entrada de função, é necessário proceder da seguinte forma:
Especifique o valor
$Nullno parâmetro Parâmetros . Você não precisa incluir o parâmetro RemoveParameter .Especifique o parâmetro UnscopedTopLevel para indicar que você está alterando uma entrada de função em uma função de nível superior nãocopada. Se você não especificar esse parâmetro quando alterar uma entrada de função em uma função sem escopo, ocorre um erro.
A remoção de todos os parâmetros de uma entrada de função é mais útil quando se quer disponibilizar apenas alguns parâmetros em um script ou cmdlet não-Exchange e excluir todos os outros parâmetros.
Se não quiser que a função tenha acesso a um script ou cmdlet não-Exchange, remova a entrada de função associada da função por completo em vez de apenas remover os parâmetros. Para mais informações sobre como remover uma entrada de função de uma função, consulte Remover uma entrada de função de uma função.
Aviso
As operações de remoção não podem ser desfeitas. Se você removeu por engano todos os parâmetros de uma entrada de função, será preciso adicioná-los manualmente outra vez.
Para remover todos os parâmetros de uma entrada de função, use a sintaxe a seguir.
Set-ManagementRoleEntry <role name>\<script or non-Exchange cmdlet> -Parameters $Null -UnscopedTopLevel
Esse exemplo remove todos os parâmetros do script FindMailboxesOverQuota.ps1 na função Administradores de Destinatários.
Set-ManagementRoleEntry "Recipient Administrators\FindMailboxesOverQuota.ps1" -Parameters $Null -UnscopedTopLevel
Para informações detalhadas de sintaxes e de parâmetros, consulte Set-ManagementRoleEntry.
Usar o Shell para aplicar um conjunto específico de parâmetros
Se quiser incluir apenas um conjunto específico de parâmetros a uma entrada de função, será necessário proceder da seguinte forma:
Especifique apenas o parâmetro Parâmetros . Não inclua os parâmetros AddParameter ou RemoveParameter .
Especifique o parâmetro UnscopedTopLevel para indicar que você está alterando uma entrada de função em uma função nãocopada. Se você não especificar esse parâmetro quando alterar uma entrada de função em uma função de nível superior sem escopo, ocorrerá um erro.
Aviso
Quando você especifica apenas o parâmetro Parâmetros , apenas os parâmetros especificados no comando são incluídos na entrada de função. Todos os outros parâmetros são removidos.
Para especificar um conjunto específico de parâmetros, use a sintaxe a seguir.
Set-ManagementRoleEntry <role name>\<script or non-Exchange cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -UnscopedTopLevel
Este exemplo inclui apenas os parâmetros Alias, DisplayName, WidgetConfig e Habilitado no cmdlet Set-Widget na função administradores de destinatários do Seattle Mail.
Set-ManagementRoleEntry "Seattle Mail Recipient Admins\Set-UMMailbox" -Parameters Alias, DisplayName, WidgetConfig, Enabled -UnscopedTopLevel
Para obter informações detalhadas de sintaxe e parâmetro, consulte Set-ManagementRoleEntry.
Outras tarefas
Após alterar uma entrada de função ou uma função de nível superior sem escopo, você poderá também:
Adicionar uma entrada de função a uma função
Gerenciar membros do grupo de função