Set-MailboxIRMAccess

Módulo:
Exchange PowerShell

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 por 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 Total).

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

Sintaxe

Default (Default) 

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

Description

Observação

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

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

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

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

Parâmetros

-AccessLevel

Aplicável: Exchange Online

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

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

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

Propriedades do parâmetro

Tipo:IRMAccessLevel
Valor padrão:None
Valores aceitos:Block
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

-Identity

Aplicável: Exchange Online

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)
  • 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

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

-User

Aplicável: Exchange Online

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

O parâmetro User especifica o representante que está impedido de ler mensagens protegidas por IRM na caixa de correio. O representante deve ser uma caixa de correio de usuário ou um usuário de email. Você pode usar qualquer valor que identifique exclusivamente o representante. 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

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
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.