Add-MailboxPermission (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2008-07-17

Use o cmdlet Add-MailboxPermission para adicionar permissões a uma caixa de correio.

Sintaxe

Add-MailboxPermission -Identity <MailboxIdParameter> -AccessRights <MailboxRights[]> -User <SecurityPrincipalIdParameter> [-Deny <SwitchParameter>] [-DomainController <Fqdn>] [-InheritanceType <None | All | Descendents | SelfAndChildren | Children>]

Add-MailboxPermission -Identity <MailboxIdParameter> -Owner <SecurityPrincipalIdParameter> [-DomainController <Fqdn>]

Add-MailboxPermission [-Identity <MailboxIdParameter>] -Instance <MailboxAcePresentationObject> [-AccessRights <MailboxRights[]>] [-Deny <SwitchParameter>] [-DomainController <Fqdn>] [-InheritanceType <None | All | Descendents | SelfAndChildren | Children>] [-User <SecurityPrincipalIdParameter>]

Descrição detalhada

Esse cmdlet permite conceder permissões a uma caixa de correio; por exemplo, conceder a um usuário acesso completo à caixa de correio de outro usuário.

Para executar o cmdlet Add-MailboxPermission, a conta utilizada precisa ter, no mínimo, esta permissão para a caixa de correio onde ela existe:

  • Administrador do Exchange Server ou Administrador da Organização do Exchange

Além disso, a conta usada pode exigir permissões adicionais no Active Directory para executar determinadas operações. Para verificar se você possui as permissões apropriadas, à conta utilizada deverá estar delegada a permissão Operadores de Conta do domínio em que a conta habilitada para caixas de correio de destino existe.

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 Obrigatório Tipo Descrição

AccessRights

Obrigatório

Microsoft.Exchange.Management.RecipientTasks.MailboxRights[]

O parâmetro AccessRights especifica os direitos necessários para executar a operação. Os valores válidos incluem:

  • FullAccess

  • SendAs

  • ExternalAccount

  • DeleteItem

  • ReadPermission

  • ChangePermission

  • ChangeOwner

Identity

Obrigatório

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Identity especifica a identidade da caixa de correio à qual novas permissões estão sendo adicionadas.

Dica

O parâmetro Identity exige o nome completo do usuário entre aspas.

Instance

Obrigatório

Microsoft.Exchange.Management.RecipientTasks.MailboxAcePresentationObject

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

Owner

Obrigatório

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

O parâmetro Owner especifica o proprietário do objeto de caixa de correio.

User

Obrigatório

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

O parâmetro User especifica a caixa de correio do usuário à qual as permissões estão sendo concedidas na outra caixa de correio.

Deny

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Deny nega permissões para o usuário na caixa de correio.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado do controlador de domínio que recupera dados do serviço de diretório Active Directory, inclua o parâmetro DomainController no comando.

InheritanceType

Opcional

System.DirectoryServices.ActiveDirectorySecurityInheritance

Use esse parâmetro para especificar se as permissões são herdadas por pastas dentro caixa de correio.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

Esse exemplo concederá a Ted Brenner acesso completo à caixa de correio de Ellen Adam.

Dica

O parâmetro Identity exige o nome completo do usuário entre aspas.

Add-MailboxPermission -Identity "Ellen Adams" -User TedBrem -Accessright Fullaccess -InheritanceType all