Set-QuarantinePermissions
Esse cmdlet só está disponível no serviço baseado em nuvem.
Nota: em vez de utilizar este cmdlet para definir permissões de política de quarentena, recomendamos que utilize o parâmetro EndUserQuarantinePermissionsValue nos cmdlets New-QuarantinePolicy e Set-QuarantinePolicy.
Utilize o cmdlet Set-QuarantinePermissions para modificar objetos de permissões de quarentena que foram criados pelo New-QuarantinePermissions e armazenados como uma variável na sessão atual do PowerShell. Utilize a variável como um valor para o parâmetro EndUserQuarantinePermission no New-QuarantinePolicy ou Set-QuarantinePolicy cmdlets na mesma sessão do PowerShell.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-QuarantinePermissions
-QuarantinePermissionsObject <QuarantinePermissions>
[[-PermissionToAllowSender] <Boolean>]
[[-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 pretende modificar, execute o nome da variável como um comando. Por exemplo, execute o comando $Perms para ver as permissões da política de quarentena armazenadas na $Perms variável .
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 da política de quarentena na variável de saída $Perms que foi criada anteriormente com o cmdlet New-QuarantinePermissions na mesma sessão do PowerShell (a $Perms variável ainda está disponível e preenchida).
Na mesma sessão do PowerShell, pode utilizar $Perms para o valor do parâmetro EndUserQuarantinePermissions num comando New-QuarantinePolicy ou Set-QuarantinePolicy.
Parâmetros
-PermissionToAllowSender
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PermissionToBlockSender especifica se os utilizadores têm permissão para adicionar o remetente da mensagem em quarentena à respetiva lista de Remetentes Seguros. Os valores válidos são:
- $true: a opção Permitir remetente está disponível para as mensagens afetadas em quarentena.
- $false: a opção Permitir remetente não está disponível para as mensagens afetadas em quarentena. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PermissionToBlockSender
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PermissionToBlockSender especifica se os utilizadores têm permissão para adicionar o remetente da mensagem em quarentena à respetiva lista de Remetentes Bloqueados. Os valores válidos são:
- $true: o remetente de blocos está disponível em notificações de quarentena para mensagens afetadas e o remetente de bloqueio está disponível para as mensagens afetadas em quarentena.
- $false: O remetente de blocos não está disponível em notificações de quarentena para mensagens afetadas e Bloquear remetente não está disponível para as mensagens afetadas em quarentena. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PermissionToDelete
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PermissionToDelete especifica se os utilizadores têm permissão para eliminar mensagens da quarentena. Os valores válidos são:
- $true: as mensagens de eliminação e Eliminação da quarentena estão disponíveis para as mensagens afetadas em quarentena.
- $false: a eliminação de mensagens e a eliminação da quarentena não estão disponíveis para as mensagens afetadas em quarentena. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PermissionToDownload
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PermissionToDownload especifica se os utilizadores têm permissão para transferir mensagens da quarentena. Os valores válidos são:
- $true: a permissão está ativada.
- $false: a permissão está desativada. Este valor é a predefinição.
Atualmente, este valor não tem qualquer efeito nas ações disponíveis nas notificações de quarentena ou na quarentena das mensagens afetadas. Os utilizadores finais não podem transferir mensagens em quarentena.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PermissionToPreview
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PermissionToPreview especifica se os utilizadores têm permissão para pré-visualizar mensagens em quarentena. Os valores válidos são:
- $true: a mensagem de pré-visualização está disponível para as mensagens afetadas em quarentena.
- $false: a mensagem de pré-visualização não está disponível para as mensagens afetadas em quarentena. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PermissionToRelease
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PermissionToRelease especifica se os utilizadores têm permissão para libertar diretamente as mensagens afetadas da quarentena. Os valores válidos são:
- $true: a versão está disponível em notificações de quarentena para mensagens afetadas e a versão (e-mail de versão) está disponível para as mensagens afetadas em quarentena.
- $false: a mensagem de lançamento não está disponível nas notificações de quarentena para as mensagens afetadas e o e-mail de Lançamento e Versão não está disponível para as mensagens afetadas em quarentena.
Não defina este 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.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PermissionToRequestRelease
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PermissionToRequestRelease especifica se os utilizadores têm permissão para pedir que as mensagens sejam libertadas da quarentena. O pedido tem de ser aprovado por um administrador. Os valores válidos são:
- $true: a Versão do Pedido está disponível nas notificações de quarentena para as mensagens afetadas e a versão do Pedido está disponível para as mensagens afetadas em quarentena.
- $false: a Versão do Pedido não está disponível nas notificações de quarentena para as mensagens afetadas e a versão do Pedido não está disponível para as mensagens afetadas em quarentena.
Não defina este 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.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 7 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PermissionToViewHeader
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PermissionToViewHeader especifica se os utilizadores têm permissão para ver os cabeçalhos das mensagens em quarentena. Os valores válidos são:
- $true: a permissão está ativada.
- $false: a permissão está desativada. Este valor é a predefinição.
Atualmente, este valor não tem qualquer efeito nas ações disponíveis nas notificações de quarentena ou na quarentena das mensagens afetadas. Ver cabeçalho da mensagem está sempre disponível para as mensagens afetadas em quarentena.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 8 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-QuarantinePermissionsObject
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro QuarantinePermissionsObject especifica a variável existente que contém as permissões de quarentena que pretende modificar. Por exemplo, se executou anteriormente o comando $Perms = New-QuarantinePermissions <permissions>, utilize o valor $Perms para este parâmetro.
Propriedades do parâmetro
| Tipo: | QuarantinePermissions |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 9 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.