New-QuarantinePermissions
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-QuarantinePermissionsEste 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 $trueEste 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 $trueEste 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 |