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