Add-MailboxPermission
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:
|
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