New-QuarantinePermissions

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet New-QuarantinePermissions per creare oggetti autorizzazioni di quarantena da usare con il cmdlet New-QuarantineTag.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

New-QuarantinePermissions
   [-PermissionToBlockSender <Boolean>]
   [-PermissionToDelete <Boolean>]
   [-PermissionToDownload <Boolean>]
   [-PermissionToPreview <Boolean>]
   [-PermissionToRelease <Boolean>]
   [-PermissionToRequestRelease <Boolean>]
   [-PermissionToViewHeader <Boolean>]
   [<CommonParameters>]

Descrizione

Il valore predefinito per tutti i parametri che non si usano è $false, quindi è necessario usare solo i parametri (autorizzazioni) che si desidera impostare su $true.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

$NoAccess = New-QuarantinePermissions

In questo esempio vengono create le stesse autorizzazioni usate dal gruppo Nessuna autorizzazione di accesso nei tag di quarantena in Conformità sicurezza & . L'oggetto permissions viene archiviato nella variabile denominata $NoAccess.

Nella stessa sessione Windows PowerShell è possibile usare $NoAccess per il valore del parametro EndUserQuarantinePermissions in un comando New-QuarantineTag o Set-QuarantineTag.

Esempio 2

$LimitedAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true

In questo esempio vengono create le stesse autorizzazioni usate dal gruppo Autorizzazioni di accesso limitato nei tag di quarantena in Conformità sicurezza & . L'oggetto permissions viene archiviato nella variabile denominata $LimitedAccess.

Nella stessa sessione Windows PowerShell è possibile usare $LimitedAccess per il valore del parametro EndUserQuarantinePermissions in un comando New-QuarantineTag o Set-QuarantineTag.

Esempio 3

$FullAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true

In questo esempio vengono create le stesse autorizzazioni usate dal gruppo Autorizzazioni di accesso completo nei tag di quarantena in Conformità sicurezza & . L'oggetto permissions viene archiviato nella variabile denominata $FullAccess.

Nella stessa sessione Windows PowerShell è possibile usare $FullAccess per il valore del parametro EndUserQuarantinePermissions in un comando New-QuarantineTag o Set-QuarantineTag.

Parametri

-PermissionToBlockSender

Il parametro PermissionToBlockSender consente di specificare se agli utenti è consentito aggiungere il mittente del messaggio in quarantena all'elenco Mittenti bloccati. I valori validi sono:

  • $true: il pulsante Blocca mittente è incluso nelle notifiche di quarantena degli utenti finali.
  • $false: il pulsante Blocca mittente non è incluso nelle notifiche di quarantena dell'utente finale. Questo è il valore predefinito.
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

Il parametro PermissionToDelete consente di specificare se agli utenti è consentito eliminare i messaggi dalla quarantena. I valori validi sono:

  • $true: il pulsante Rimuovi dalla quarantena è incluso nei dettagli del messaggio in quarantena.
  • $false: il pulsante Rimuovi dalla quarantena non è incluso nei dettagli del messaggio in quarantena. Questo è il valore predefinito.
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

Il parametro PermissionToDownload consente di specificare se agli utenti è consentito scaricare i messaggi dalla quarantena. I valori validi sono:

  • $true: l'autorizzazione è abilitata.
  • $false: l'autorizzazione è disabilitata. Questo è il valore predefinito.

Attualmente, questo valore non ha alcun effetto sui pulsanti inclusi nelle notifiche di posta indesiderata dell'utente finale o nei dettagli dei messaggi in quarantena.

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

Il parametro PermissionToPreview consente di specificare se agli utenti è consentito visualizzare in anteprima i messaggi in quarantena. I valori validi sono:

  • $true: il pulsante Del messaggio di anteprima è incluso nei dettagli del messaggio in quarantena.
  • $false: il pulsante Del messaggio di anteprima non è incluso nei dettagli del messaggio in quarantena. Questo è il valore predefinito.
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

Il parametro PermissionToRelease consente di specificare se agli utenti è consentito rilasciare direttamente i messaggi dalla quarantena. I valori validi sono:

  • $true: il pulsante Release è incluso nelle notifiche di posta indesiderata dell'utente finale e il pulsante Release message è incluso nei dettagli del messaggio in quarantena.
  • $false: il pulsante Release non è incluso nelle notifiche di posta indesiderata dell'utente finale e il pulsante Release message non è incluso nei dettagli del messaggio in quarantena. Questo è il valore predefinito.

Non impostare questo parametro e il parametro PermissionToRequestRelease su $true. Impostare un parametro su $true e l'altro su $false oppure impostare entrambi i parametri su $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

Il parametro PermissionToRequestRelease consente di specificare se agli utenti è consentito richiedere il rilascio dei messaggi dalla quarantena. La richiesta deve essere approvata da un amministratore. I valori validi sono:

  • $true: il pulsante Release è incluso nelle notifiche di posta indesiderata dell'utente finale e il pulsante Release message è incluso nei dettagli del messaggio in quarantena.
  • $false: il pulsante Release non è incluso nelle notifiche di posta indesiderata dell'utente finale e il pulsante Release message non è incluso nei dettagli del messaggio in quarantena. Questo è il valore predefinito.

Non impostare questo parametro e il parametro PermissionRelease su $true. Impostare un parametro su $true e l'altro su $false oppure impostare entrambi i parametri su $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

Il parametro PermissionToViewHeader consente di specificare se agli utenti è consentito visualizzare le intestazioni dei messaggi in quarantena. I valori validi sono:

  • $true: l'autorizzazione è abilitata.
  • $false: l'autorizzazione è disabilitata. Questo è il valore predefinito.

Attualmente, questo valore non ha alcun effetto sui pulsanti inclusi nelle notifiche di posta indesiderata dell'utente finale o nei dettagli dei messaggi in quarantena. Il pulsante Visualizza intestazione messaggio è sempre disponibile nei dettagli del messaggio in quarantena.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection