Share via

Remove-MailboxPermission

  • Artigo

 

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

Tópico modificado em: 2008-07-16

Use o cmdlet Remove-MailboxPermission para remover permissões de uma caixa de correio de usuário.

Sintaxe

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

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

Remove-MailboxPermission -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Esse cmdlet permite remover permissões de uma caixa de correio de usuário, removendo, por exemplo, o acesso total a outra caixa de correio de usuário.

Para executar o cmdlet Remove-MailboxPermission, você deve usar a conta à qual esteja delegado o seguinte:

  • Função Administrador de Destinatários 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, deverá estar delegada à conta utilizada 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 Necessário Tipo Descrição

AccessRights

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

Necessário

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Identity especifica a identidade da caixa de correio para a qual uma permissão é necessária.

Instance

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

User

Necessário

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

O parâmetro User especifica a caixa de correio do usuário que obterá as permissões.

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 para este parâmetro.

Deny

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Deny nega permissões para o usuário no objeto do Active Directory.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

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

InheritanceType

Opcional

System.DirectoryServices.ActiveDirectorySecurityInheritance

O parâmetro InheritanceType especifica se as permissões são herdadas por pastas dentro da caixa de correio.

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

Esse exemplo removerá os direitos de acesso total do usuário Test2 à caixa de correio do usuário Test1.

Remove-MailboxPermission -Identity Test1 -User Test2 -AccessRight FullAccess -InheritanceType All