Set-QuarantinePermissions

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Online, Exchange Online Protection

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

Use o cmdlet Set-QuarantinePermissions para modificar objetos de permissões de quarentena usados em marcas de quarentena (os cmdlets New-QuarantineTag ou Set-QuarantineTag). Esse cmdlet funciona apenas em objetos de permissões que foram criados pelo cmdlet New-QuarantinePermissions e armazenados em uma variável que está disponível atualmente na sessão Windows PowerShell.

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

Syntax

Set-QuarantinePermissions
   -QuarantinePermissionsObject <QuarantinePermissions>
   [-PermissionToBlockSender <Boolean>]
   [-PermissionToDelete <Boolean>]
   [-PermissionToDownload <Boolean>]
   [-PermissionToPreview <Boolean>]
   [-PermissionToRelease <Boolean>]
   [-PermissionToRequestRelease <Boolean>]
   [-PermissionToViewHeader <Boolean>]
   [<CommonParameters>]

Description

Para ver o valor atual do objeto de permissões que você deseja modificar, execute o nome da variável como um comando. Por exemplo, execute o comando $Perms para ver as permissões de marca de quarentena armazenadas na $Perms variável.

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-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false

Este exemplo modifica as permissões de marca de quarentena especificadas no objeto de permissões de saída $Perms que foi criado anteriormente na mesma sessão de Windows PowerShell (a $Perms variável ainda está disponível e preenchida).

Na mesma sessão de Windows PowerShell, você pode usar $Perms para o valor do parâmetro EndUserQuarantinePermissions em um comando New-QuarantineTag ou Set-QuarantineTag.

Parâmetros

-PermissionToBlockSender

O parâmetro PermissionToBlockSender especifica se os usuários podem adicionar o remetente de mensagens em quarentena à lista de Remetentes Bloqueados. Os valores válidos são:

$true: o botão Remetente bloquear está incluído em notificações de quarentena do usuário final.
$false: o botão Bloquear remetente não está incluído em notificações de quarentena do usuário final. Esse é o valor padrão.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToDelete

O parâmetro PermissionToDelete especifica se os usuários podem excluir mensagens da quarentena. Os valores válidos são:

$true: o botão Remover da quarentena está incluído nos detalhes da mensagem em quarentena.
$false: o botão Remover da quarentena não está incluído nos detalhes da mensagem em quarentena. Esse é o valor padrão.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToDownload

O parâmetro PermissionToDownload especifica se os usuários podem baixar mensagens da quarentena. Os valores válidos são:

$true: a permissão está habilitada.
$false: a permissão está desabilitada. Esse é o valor padrão.

Atualmente, esse valor não tem efeito nos botões incluídos em notificações de spam do usuário final ou em detalhes da mensagem em quarentena.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToPreview

O parâmetro PermissionToPreview especifica se os usuários podem visualizar mensagens em quarentena. Os valores válidos são:

$true: o botão Visualizar mensagem está incluído nos detalhes da mensagem em quarentena.
$false: o botão Visualizar mensagem não está incluído nos detalhes da mensagem em quarentena. Esse é o valor padrão.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToRelease

O parâmetro PermissionToRelease especifica se os usuários podem liberar diretamente mensagens da quarentena. Os valores válidos são:

$true: o botão Versão está incluído em notificações de spam do usuário final e o botão Liberar mensagem está incluído nos detalhes da mensagem em quarentena.
$false: o botão Versão não está incluído em notificações de spam do usuário final e o botão Liberar mensagem não está incluído nos detalhes da mensagem em quarentena. Esse é o valor padrão.

Não defina esse parâmetro e o parâmetro PermissionToRequestRelease como $true. Defina um parâmetro para $true e o outro para $false ou defina ambos os parâmetros como $false.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToRequestRelease

O parâmetro PermissionToRequestRelease especifica se os usuários têm permissão para solicitar que as mensagens sejam liberadas da quarentena. A solicitação deve ser aprovada por um administrador. Os valores válidos são:

$true: o botão Versão está incluído em notificações de spam do usuário final e o botão Liberar mensagem está incluído nos detalhes da mensagem em quarentena.
$false: o botão Versão não está incluído em notificações de spam do usuário final e o botão Liberar mensagem não está incluído nos detalhes da mensagem em quarentena. Esse é o valor padrão.

Não defina esse parâmetro e o parâmetro PermissionRelease como $true. Defina um parâmetro para $true e o outro para $false ou defina ambos os parâmetros como $false.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToViewHeader

O parâmetro PermissionToViewHeader especifica se os usuários podem exibir os cabeçalhos de mensagem de mensagens em quarentena. Os valores válidos são:

$true: a permissão está habilitada.
$false: a permissão está desabilitada. Esse é o valor padrão.

Atualmente, esse valor não tem efeito nos botões incluídos em notificações de spam do usuário final ou em detalhes da mensagem em quarentena. O botão Exibir cabeçalho de mensagem está sempre disponível nos detalhes da mensagem em quarentena.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-QuarantinePermissionsObject

O parâmetro QuarantinePermissionsObject especifica a variável que contém o objeto de permissões de quarentena que você deseja modificar. Por exemplo, se você executou o comando $Perms = New-QuarantinePermissions <permissions>, use o valor $Perms para este parâmetro.

Type:	QuarantinePermissions
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection