New-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 New-QuarantinePermissions para criar uma variável que contenha um objeto de permissões de quarentena para usar com 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)
New-QuarantinePermissions
[[-PermissionToAllowSender] <Boolean>]
[[-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 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
$NoAccess = New-QuarantinePermissions
Este exemplo cria as mesmas permissões usadas pelo grupo Sem permissões de acesso em políticas de quarentena. O objeto permissions é armazenado na variável chamada $NoAccess.
Na mesma sessão do PowerShell, você pode usar $NoAccess para o valor do parâmetro EndUserQuarantinePermissions em um comando New-QuarantinePolicy ou Set-QuarantinePolicy.
Exemplo 2
$LimitedAccess = New-QuarantinePermissions -PermissionToAllowSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true
Este exemplo cria as mesmas permissões usadas pelo grupo Permissões de acesso limitado em políticas de quarentena. O objeto permissions é armazenado na variável chamada $LimitedAccess.
Na mesma sessão do PowerShell, você pode usar $LimitedAccess para o valor do parâmetro EndUserQuarantinePermissions em um comando New-QuarantinePolicy ou Set-QuarantinePolicy.
Exemplo 3
$FullAccess = New-QuarantinePermissions -PermissionToAllowSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true
Este exemplo cria as mesmas permissões usadas pelo grupo Permissões de acesso completo em políticas de quarentena. O objeto permissions é armazenado na variável chamada $FullAccess.
Na mesma sessão do PowerShell, você pode usar $FullAccess 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 PermissionToAllowSender especifica se os usuários têm permissão para adicionar o remetente da mensagem em quarentena à 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 |
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.