New-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 New-QuarantinePermissions para criar uma variável que contém um objeto de permissões de quarentena a utilizar com 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)
New-QuarantinePermissions
[[-PermissionToAllowSender] <Boolean>]
[[-PermissionToBlockSender] <Boolean>]
[[-PermissionToDelete] <Boolean>]
[[-PermissionToDownload] <Boolean>]
[[-PermissionToPreview] <Boolean>]
[[-PermissionToRelease] <Boolean>]
[[-PermissionToRequestRelease] <Boolean>]
[[-PermissionToViewHeader] <Boolean>]
[<CommonParameters>]
Description
O valor predefinido para quaisquer parâmetros que não utilize é $false, pelo que só precisa de utilizar parâmetros (permissões) que pretende definir como $true.
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
$NoAccess = New-QuarantinePermissions
Este exemplo cria as mesmas permissões que são utilizadas pelo grupo Sem permissões de acesso nas políticas de quarentena. O objeto de permissões é armazenado na variável com o nome $NoAccess.
Na mesma sessão do PowerShell, pode utilizar $NoAccess para o valor do parâmetro EndUserQuarantinePermissions num 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 que são utilizadas pelo grupo Permissões de acesso limitado nas políticas de quarentena. O objeto de permissões é armazenado na variável com o nome $LimitedAccess.
Na mesma sessão do PowerShell, pode utilizar $LimitedAccess para o valor do parâmetro EndUserQuarantinePermissions num 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 que são utilizadas pelo grupo Permissões de acesso total nas políticas de quarentena. O objeto de permissões é armazenado na variável com o nome $FullAccess.
Na mesma sessão do PowerShell, pode utilizar $FullAccess 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 PermissionToAllowSender 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 |
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.