Set-QuarantinePermissions
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 $falseEste 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 |