Remove-MailboxPermission

Módulo:
Exchange PowerShell

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ambiente ou de outro.

Use o cmdlet Remove-MailboxPermission para remover permissões da caixa de correio de um usuário ou de um usuário de email do Exchange Server 2016, Exchange Server 2019 ou Exchange Online.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

AccessRights 

Remove-MailboxPermission
    [-Identity] <MailboxIdParameter>
    -AccessRights <MailboxRights[]>
    -User <SecurityPrincipalIdParameter>
    [-BypassMasterAccountSid]
    [-Confirm]
    [-Deny]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-InheritanceType <ActiveDirectorySecurityInheritance>]
    [-SoftDeletedMailbox]
    [-WhatIf]
    [<CommonParameters>]

Instance 

Remove-MailboxPermission
    [[-Identity] <MailboxIdParameter>]
    -Instance <MailboxAcePresentationObject>
    [-AccessRights <MailboxRights[]>]
    [-Confirm]
    [-Deny]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-InheritanceType <ActiveDirectorySecurityInheritance>]
    [-User <SecurityPrincipalIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Owner 

Remove-MailboxPermission
    [[-Identity] <MailboxIdParameter>]
    [-BypassMasterAccountSid]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

ClearAutoMapping 

Remove-MailboxPermission
    [-Identity] <MailboxIdParameter>
    [-ClearAutoMapping]
    [-BypassMasterAccountSid]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

ResetDefault 

Remove-MailboxPermission
    [-Identity] <MailboxIdParameter>
    [-ResetDefault]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

Description

O cmdlet Remove-MailboxPermission 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 esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Remove-MailboxPermission -Identity "Yuuto Sasaki" -User "Pedro Pizarro" -AccessRights FullAccess -InheritanceType All

Este exemplo remove a permissão de acesso total de Pedro Pizarro para a caixa de correio de Yuuto Sasaki.

Exemplo 2

Remove-MailboxPermission -Identity "HR Project" -ClearAutoMapping

No Exchange Online, este exemplo exclui a caixa de correio do Projeto de RH do mapeamento automático no Outlook para todos os usuários que têm permissão de Acesso Total à caixa de correio.

Parâmetros

-AccessRights

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro AccessRights especifica a permissão que você deseja remover do usuário na caixa de correio. Os valores válidos são:

  • Acesso Completo
  • SendAs
  • Conta Externa
  • DeleteItem
  • ReadPermission
  • ChangePermission
  • ChangeOwner

Vários valores, separados por vírgulas, podem ser especificados.

Propriedades do parâmetro

Tipo:

MailboxRights[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessRights
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Instance
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BypassMasterAccountSid

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

A opção BypassMasterAccountSid suprime o seguinte erro: Can't remove the access control entry on the object "User" for the user account because the ACE doesn't exist on the object. Você não precisa especificar um valor com essa opção.

Normalmente, você só precisa usar essa opção em ambientes herdados do Office 365 Dedicated ou ITAR.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessRights
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Owner
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ClearAutoMapping
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ClearAutoMapping

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional no serviço baseado em nuvem.

O parâmetro ClearAutoMapping exclui a caixa de correio do recurso de mapeamento automático no Microsoft Outlook. Não é preciso especificar um valor com essa opção.

O mapeamento automático usa a Descoberta Automática para adicionar automaticamente caixas de correio ao perfil do Outlook de um usuário se o usuário tiver permissão de Acesso Total para a caixa de correio. Use esta opção para excluir esta caixa de correio do mapeamento automático para todos os usuários que têm permissão de Acesso Total para a caixa de correio.

Não é possível usar essa opção com os parâmetros User ou AccessRights.

Observação: se você usar essa opção em um comando Remove-MailboxPermission, mas a caixa de correio não for excluída do mapeamento automático para um usuário, remova a permissão de Acesso Total do usuário usando o cmdlet Remove-MailboxPermission com o parâmetro User. Em seguida, reatribua a permissão de Acesso Total do usuário na caixa de correio usando o cmdlet Add-MailboxPermission com o parâmetro AutoMapping definido como o valor $false.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ClearAutoMapping
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Deny

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção Negar especifica que as permissões que você está removendo são permissões Negar. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessRights
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Instance
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GroupMailbox

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

A opção GroupMailbox é necessária para remover permissões de uma caixa de correio de Grupo do Microsoft 365. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessRights
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Owner
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Instance
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Identity especifica a caixa de correio da qual você está removendo as permissões. Você pode usar qualquer valor que identifique exclusivamente a caixa de correio: Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domínio\Nome de usuário
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Propriedades do parâmetro

Tipo:MailboxIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessRights
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
Owner
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ClearAutoMapping
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ResetDefault
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IgnoreDefaultScope

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo de destinatário padrão para a sessão do PowerShell do Exchange e usar toda a floresta como escopo. Não é preciso especificar um valor com essa opção.

Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, mas também introduz as seguintes restrições:

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InheritanceType

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro InheritanceType especifica se as permissões são herdadas por pastas dentro da caixa de correio. Os valores válidos são:

  • Nenhum
  • Todos (este é o valor padrão)
  • Crianças
  • Descendentes [sic]
  • SelfAndChildren

Propriedades do parâmetro

Tipo:ActiveDirectorySecurityInheritance
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessRights
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Instance
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Instance

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parâmetro está disponível somente no Exchange local.

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

Propriedades do parâmetro

Tipo:MailboxAcePresentationObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Instance
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResetDefault

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro só é funcional no serviço baseado em nuvem.

A opção ResetDefault redefine o descritor de segurança padrão da caixa de correio. Não é preciso especificar um valor com essa opção.

As permissões na caixa de correio são redefinidas para que apenas o proprietário da caixa de correio tenha permissão de Acesso Total para a caixa de correio. Os seguintes tipos de permissões não são afetados:

  • Permissões de destinatário (por exemplo, SendAs, SendOnBehalf e representantes).
  • Permissões de pasta de caixa de correio atribuídas por meio de cmdlets MailboxFolderPermission.
  • Permissões da pasta da caixa de correio atribuídas usando o Outlook ou outros clientes MAPI.

Além disso, como essa opção remove a permissão de Acesso Total de outros usuários na caixa de correio, a caixa de correio não é mais mapeada automaticamente pela Descoberta Automática nos perfis do Outlook de outros usuários.

Você não pode usar essa opção com o usuário para parâmetros AccessRights.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Instance
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SoftDeletedMailbox

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

O comutador SoftDeletedMailbox é necessário para remover permissões de uma caixa de correio excluída temporariamente. Não é preciso especificar um valor com essa opção.

Caixas de correio excluídas de forma flexível são caixas de correio excluídas e que ainda podem ser recuperadas.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessRights
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-User

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro User especifica quais permissões estão sendo removidas da caixa de correio especificada. Você pode especificar os seguintes tipos de usuários ou grupos (entidades de segurança) para esse parâmetro:

  • Usuário da caixa de correio
  • Usuários de e-mail
  • Grupos de segurança

Para obter os melhores resultados, recomendamos o uso dos seguintes valores:

  • UPN: por exemplo, user@contoso.com (somente usuários).
  • Domain\SamAccountName: Por exemplo, contoso\user.

Caso contrário, você poderá usar qualquer valor que identifique exclusivamente o usuário ou grupo. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domínio\Nome de usuário
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Propriedades do parâmetro

Tipo:SecurityPrincipalIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccessRights
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Instance
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.