Set-MailboxIRMAccess

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online

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

Use o cmdlet Set-MailboxIRMAccess para bloquear o acesso de delegado a mensagens protegidas pelo IRM em outras caixas de correio (caixas de correio compartilhadas ou caixas de correio de usuário em que os delegados têm permissão de Acesso Completo).

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

Syntax

Set-MailboxIRMAccess
   -AccessLevel <IRMAccessLevel>
   [-Identity] <MailboxIdParameter>
   -User <SecurityPrincipalIdParameter>
   [<CommonParameters>]

Description

Observação

Esse cmdlet funciona apenas para delegados que já têm permissão de Acesso Completo para a caixa de correio. Para obter mais informações, consulte Gerenciar permissões para destinatários em Exchange Online.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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

Set-MailboxIRMAccess -Identity lynette@contoso.onmicrosoft.com -User chris@contoso.onmicrosoft.com -AccessLevel Block

Este exemplo impede que o delegado Chris leia mensagens protegidas por IRM na caixa de correio de Lynette.

Parâmetros

-AccessLevel

O parâmetro AccessLevel especifica o que os delegados podem fazer com mensagens protegidas por IRM na caixa de correio especificada pelo parâmetro Identity.

O único valor para esse parâmetro é Block, o que significa que você só pode usar esse cmdlet para bloquear o acesso de delegado a mensagens protegidas por IRM na caixa de correio.

Para permitir o acesso a mensagens protegidas pelo IRM na caixa de correio, use o cmdlet Remove-MailboxIRMAccess.

Type:IRMAccessLevel
Accepted values:Block
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

O parâmetro Identity especifica a caixa de correio que você deseja modificar. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo,

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:MailboxIdParameter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-User

Observação: os delegados que você especificar com esse parâmetro já devem ter permissão de Acesso Completo para a caixa de correio. Para obter mais informações, consulte Gerenciar permissões para destinatários em Exchange Online.

O parâmetro User especifica o delegado que está impedido de ler mensagens protegidas por IRM na caixa de correio. O delegado deve ser uma caixa de correio de usuário ou um usuário de email. Você pode usar qualquer valor que identifique exclusivamente o delegado. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:SecurityPrincipalIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online