Add-MailboxPermission

  • Artigo

 

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

Tópico modificado em: 2013-04-08

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

Sintaxe

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

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

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

Descrição detalhada

Este cmdlet permite que você conceda permissões para uma caixa de correio. Por exemplo, é possível utiliza-lo para conceder a um usuário acesso completo à caixa de correio de outro usuário

Para executar o cmdlet Add-MailboxPermission , a conta utilizada deve ser delegada, no mínimo, o seguinte no servidor no qual reside a caixa de correio:

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

Além disso, a conta usada pode exigir permissões adicionais nos Serviços de Domínio Active Directory para executar determinadas operações. Para certificar-se que você possui as permissões apropriadas, a conta utilizada deve ser delegada a permissão de Operadores de Conta no domínio em que existe a conta habilitada para caixas de correio de destino.

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

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

AccessRights

Necessário

Microsoft.Exchange.Management.RecipientTasks.MailboxRights[]

O AccessRights parameter especifica os direitos necessários para realizar a operação. Os valores válidos incluem:

  • FullAccess

  • ExternalAccount

  • DeleteItem

  • ReadPermission

  • ChangePermission

  • ChangeOwner

Identity

Necessá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 identidade exige o nome completo do usuário entre aspas.

Instance

Necessário

Microsoft.Exchange.Management.RecipientTasks.MailboxAcePresentationObject

O parâmetro Instance permite a passagem de um objeto inteiro para o comando para ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

Owner

Necessário

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

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

User

Necessá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 ao 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

Este parâmetro é usado para especificar a limitação da estrutura de objeto do Active Directory que herda as permissões de "leitura".

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 executaria no objeto. Ao utilizar o parâmetro WhatIf , é possível visualizar quais alterações ocorreriam sem precisar aplicar nenhuma dessas alterações. Não é necessário 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

Este exemplo irá conceder a Ted Bremer acesso completo à caixa de correio de Ellen Adams.

Dica

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

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