Set-QuarantinePermissions
Esse cmdlet só está disponível no serviço baseado em nuvem.
Observação: em vez de usar esse cmdlet para definir permissões de política de quarentena, recomendamos usar o parâmetro EndUserQuarantinePermissionsValue nos cmdlets New-QuarantinePolicy e Set-QuarantinePolicy.
Use 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. Você usa a variável como um valor para o parâmetro EndUserQuarantinePermission nos cmdlets New-QuarantinePolicy ou Set-QuarantinePolicy 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 permissions que você deseja 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, 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 da política de $Perms quarentena na variável existente que foi criada anteriormente usando 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, você pode usar $Perms para o valor do parâmetro EndUserQuarantinePermissions em um comando New-QuarantinePolicy ou Set-QuarantinePolicy.
Parâmetros
-PermissionToAllowSender
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro PermissionToBlockSender especifica se os usuários têm permissão para adicionar o remetente da mensagem em quarentena à sua lista de remetentes confiáveis. Os valores válidos são:
- $true: Permitir remetente está disponível para mensagens afetadas em quarentena.
- $false: Permitir remetente não está disponível para mensagens afetadas na quarentena. Esse valor é o padrã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, complemento de segurança interno para caixas de correio locais
O parâmetro PermissionToBlockSender especifica se os usuários têm permissão para adicionar o remetente da mensagem em quarentena à lista de Remetentes Bloqueados. Os valores válidos são:
- $true: Bloquear remetente está disponível nas notificações de quarentena para mensagens afetadas e Bloquear remetente está disponível para mensagens afetadas na quarentena.
- $false: Bloquear remetente não está disponível nas notificações de quarentena para mensagens afetadas e Bloquear remetente não está disponível para mensagens afetadas na quarentena. Esse valor é o padrã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, complemento de segurança interno para caixas de correio locais
O parâmetro PermissionToDelete especifica se os usuários têm permissão para excluir mensagens da quarentena. Os valores válidos são:
- $true: Excluir mensagens e Excluir da quarentena estão disponíveis para mensagens afetadas na quarentena.
- $false: Excluir mensagens e Excluir da quarentena não estão disponíveis para mensagens afetadas na quarentena. Esse valor é o padrã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, complemento de segurança interno para caixas de correio locais
O parâmetro PermissionToDownload especifica se os usuários têm permissão para baixar mensagens da quarentena. Os valores válidos são:
- $true: A permissão está habilitada.
- $false: a permissão está desabilitada. Esse valor é o padrão.
Atualmente, esse valor não tem efeito sobre as ações disponíveis em notificações de quarentena ou quarentena para mensagens afetadas. Os usuários finais não podem baixar 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, complemento de segurança interno para caixas de correio locais
O parâmetro PermissionToPreview especifica se os usuários têm permissão para visualizar mensagens em quarentena. Os valores válidos são:
- $true: A mensagem de visualização está disponível para mensagens afetadas em quarentena.
- $false: A mensagem de visualização não está disponível para mensagens afetadas na quarentena. Esse valor é o padrã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, complemento de segurança interno para caixas de correio locais
O parâmetro PermissionToRelease especifica se os usuários têm permissão para liberar diretamente as mensagens afetadas da quarentena. Os valores válidos são:
- $true: A versão está disponível nas notificações de quarentena para mensagens afetadas, e a versão (e-mail de liberação) está disponível para mensagens afetadas na quarentena.
- $false: A mensagem de liberação não está disponível nas notificações de quarentena para mensagens afetadas, e o email de liberação e liberação não está disponível para mensagens afetadas na quarentena.
Não defina esse parâmetro e o parâmetro PermissionToRequestRelease como $true. Defina um parâmetro como $true e o outro como $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, complemento de segurança interno para caixas de correio locais
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: A Solicitação de Liberação está disponível nas notificações de quarentena para mensagens afetadas e a Solicitação de liberação está disponível para mensagens afetadas na quarentena.
- $false: a Solicitação de Liberação não está disponível nas notificações de quarentena para mensagens afetadas, e a Solicitação de liberação não está disponível para mensagens afetadas na quarentena.
Não defina esse parâmetro e o parâmetro PermissionRelease como $true. Defina um parâmetro como $true e o outro como $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, complemento de segurança interno para caixas de correio locais
O parâmetro PermissionToViewHeader especifica se os usuários têm permissão para exibir os cabeçalhos das mensagens em quarentena. Os valores válidos são:
- $true: A permissão está habilitada.
- $false: a permissão está desabilitada. Esse valor é o padrão.
Atualmente, esse valor não tem efeito sobre as ações disponíveis em notificações de quarentena ou quarentena para mensagens afetadas. Exibir cabeçalho de mensagem está sempre disponível para 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, complemento de segurança interno para caixas de correio locais
O parâmetro QuarantinePermissionsObject especifica a variável existente que contém permissões de quarentena que você deseja modificar. Por exemplo, se você executou o comando $Perms = New-QuarantinePermissions <permissions>anteriormente, use o valor $Perms desse 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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.