Adicionar uma entrada de função para uma função de nível superior sem escopo
Aplica-se a: Exchange Server 2013
Você poderá adicionar scripts e cmdlets não-Exchange a funções de gerenciamento de nível superior sem escopo se quiser disponibilizar novos scripts ou cmdlets não-Exchange a funções sem escopo existentes. Esses scripts e cmdlets não-Exchange são adicionados como entradas de função de gerenciamento a funções de gerenciamento de nível superior sem escopo. Eles podem ser usados por essas entradas de função de nível superior sem escopo ou qualquer função sem escopo derivada de funções de nível superior. 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 adicionar 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 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ções, 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.
Adicionar uma entrada de função de script a uma função de nível superior sem escopo
Se quiser adicionar um script a uma função sem escopo existente, use este procedimento. Se quiser adicionar um cmdlet não-Exchange a uma função sem escopo existente, consulte "Adicionar uma entrada de função de cmdlet não-Exchange a uma função de nível superior sem escopo" mais adiante neste tópico.
Para adicionar um script do PowerShell do Windows a uma função de nível superior sem escopo, é preciso adicionar uma entrada de função de gerenciamento à função. A entrada de função contém o nome do script e os parâmetros do script que você deseja tornar disponíveis à função.
O script deve residir no diretório Scripts no caminho de instalação do Microsoft Exchange Server 2013 em todos os servidores que executam um Exchange 2013 onde os usuários possam se conectar para executar o script. Se um usuário tiver acesso para executar um script, mas o script não estiver localizado no servidor do Exchange 2013 ao qual o usuário está conectado, ocorre um erro. Por padrão, o caminho para o diretório Scripts é C:\Arquivos de Programas\Microsoft\Exchange Server\V15\Scripts.
Depois de copiar o script para os servidores apropriados do Exchange 2013 e decidir quais parâmetros do script devem ser usados, crie a entrada de função usando a sintaxe a seguir.
Add-ManagementRoleEntry <unscoped top-level role name>\<script filename> -Parameters <parameter 1, parameter 2, parameter...> -Type Script -UnscopedTopLevel
Este exemplo adiciona o script BulkProvisionUsers.ps1 à função Scripts de TI com os parâmetros Nome e Local .
Add-ManagementRoleEntry "IT Scripts\BulkProvisionUsers.ps1" -Parameters Name, Location -Type Script -UnscopedTopLevel
Observação
O cmdlet Add-ManagementRoleEntry realiza uma validação básica para garantir que você tenha adicionado apenas os parâmetros existentes no script. Entretanto, nenhuma outra validação é realizada depois que a entrada de função for adicionada. Se parâmetros forem adicionados ou removidos posteriormente, você terá que atualizar manualmente as entradas de função que contenham o script.
Adicionar uma entrada de função de cmdlet não-Exchange a uma função de nível superior sem escopo
Se quiser adicionar um cmdlet não-Exchange a uma função sem escopo existente, use este procedimento. Se você quiser adicionar um script a uma função sem escopo existente, consulte a seção "Adicionar uma entrada de função de script a uma função de nível superior sem escopo" já mencionada neste tópico.
Para adicionar um cmdlet que não seja do Exchange a uma função de nível superior sem escopo, é preciso adicionar uma entrada de função de gerenciamento à função. A entrada de função contém o snap-in do cmdlet, o nome do cmdlet e os parâmetros do cmdlet que você deseja tornar disponível à função.
Se você adicionar cmdlets que não sejam do Exchange à nova função, os cmdlets deverão ser instalados em todos os servidores do Exchange 2013 nos quais os usuários possam se conectar para executar os cmdlets. Para aprender a instalar e registrar corretamente os snap-ins do Windows PowerShell que contêm os cmdlets que você deseja usar, consulte a documentação do Produto.
Após instalar o snap-in do Windows PowerShell que contém os cmdlets nos servidores do Exchange 2013 apropriados e decidir quais parâmetros do cmdlet devem ser usados, crie a entrada de função usando a sintaxe a seguir.
Add-ManagementRoleEntry <unscoped top-level role name>\<cmdlet name> -PSSnapinName <snap-in name> -Parameters <parameter 1, parameter 2, parameter...> -Type Cmdlet -UnscopedTopLevel
Este exemplo adiciona o cmdlet Set-WidgetConfiguration no Contoso. Administração. O snap-in de cmdlets na função Cmdget Cmdlets com os parâmetros Banco de Dados e Tamanho.
Add-ManagementRoleEntry "Widget Cmdlets\Set-WidgetConfiguration" -PSSnapinName Contoso.Admin.Cmdlets -Parameters Database, Size -Type Cmdlet -UnscopedTopLevel
Observação
O cmdlet Add-ManagementRoleEntry realiza uma validação básica para garantir que você tenha adicionado apenas os parâmetros existentes no cmdlet. Entretanto, nenhuma outra validação é realizada depois que a entrada de função for adicionada. Se o cmdlet for alterado posteriormente, e se parâmetros forem adicionados ou removidos, você terá que atualizar manualmente as entradas de função que contenham o cmdlet.
Outras tarefas
Após adicionar 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