New-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 New-QuarantinePermissions para criar objetos de permissões de quarentena a serem usados com o cmdlet New-QuarantineTag.

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

Syntax

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

Description

O valor padrão para todos os parâmetros que você não usa é $false, portanto, você só precisa usar parâmetros (permissões) que deseja definir como $true.

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

$NoAccess = New-QuarantinePermissions

Este exemplo cria as mesmas permissões usadas pelo grupo Sem permissões de acesso em marcas de quarentena na Conformidade de Segurança & . O objeto permissions é armazenado na variável chamada $NoAccess.

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

Exemplo 2

$LimitedAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true

Este exemplo cria as mesmas permissões usadas pelo grupo de permissões de acesso limitado em marcas de quarentena na Conformidade de Segurança & . O objeto permissions é armazenado na variável chamada $LimitedAccess.

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

Exemplo 3

$FullAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true

Este exemplo cria as mesmas permissões usadas pelo grupo de permissões de acesso completo em marcas de quarentena na Conformidade de Segurança & . O objeto permissions é armazenado na variável chamada $FullAccess.

Na mesma sessão de Windows PowerShell, você pode usar $FullAccess 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