Add-ExchangeAdministrator

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-22

Use o cmdlet Add-ExchangeAdministrator para adicionar um usuário ou grupo a uma função do Microsoft Exchange Server 2007 específica.

Sintaxe

Add-ExchangeAdministrator -Identity <SecurityPrincipalIdParameter> -Role <OrgAdmin | RecipientAdmin | ServerAdmin | ViewOnlyAdmin | PublicFolderAdmin> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Scope <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Add-ExchangeAdministrator, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador da Organização do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

O parâmetro Identity especifica o usuário a ser adicionado à função.

Role

Necessário

Microsoft.Exchange.Management.RecipientTasks.DelegateRoleType

O parâmetro Role retorna apenas o tipo de função especificado.

Scope

Opcional

System.String

O parâmetro Scope especifica o nome do servidor no qual o usuário terá privilégios administrativos. Scope é exigido ao definir a função ServerAdmin. Quando a função é OrgAdmin ou MailboxAdmin, o escopo é a organização inteira.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro DomainController especifica o controlador de domínio a ser usado para gravar essa alteração de configuração no Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

A seguir, exemplos do comando Add-ExchangeAdministrator.

O primeiro exemplo adiciona o usuário Ted à função OrgAdmin.

O segundo exemplo adiciona o usuário Iliana à função ServerAdmin no servidor Exchange 2007, Contoso-Mail-01.

Add-ExchangeAdministrator -Role OrgAdmin -Identity Contoso\Ted
Add-ExchangeAdministrator -Role ServerAdmin -Identity Contoso\Iliana -Scope Contoso-Mail-01