Set-QuarantinePermissions

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-QuarantinePermissions per modificare gli oggetti autorizzazioni di quarantena usati nei tag di quarantena (cmdlet New-QuarantineTag o Set-QuarantineTag). Questo cmdlet funziona solo sugli oggetti autorizzazioni creati dal cmdlet New-QuarantinePermissions e archiviati in una variabile attualmente disponibile nella sessione di Windows PowerShell.

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

Sintassi

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

Descrizione

Per visualizzare il valore corrente dell'oggetto permissions da modificare, eseguire il nome della variabile come comando. Eseguire ad esempio il comando $Perms per visualizzare le autorizzazioni del tag di quarantena archiviate nella $Perms variabile .

È 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

Set-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false

In questo esempio vengono modificate le autorizzazioni del tag di quarantena specificate nell'oggetto autorizzazioni di uscita $Perms creato in precedenza nella stessa sessione di Windows PowerShell (la $Perms variabile è ancora disponibile e popolata).

Nella stessa sessione Windows PowerShell è possibile usare $Perms 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

-QuarantinePermissionsObject

Il parametro QuarantinePermissionsObject specifica la variabile che contiene l'oggetto autorizzazioni di quarantena che si desidera modificare. Ad esempio, se è stato eseguito il comando $Perms = New-QuarantinePermissions <permissions>, usare il valore $Perms per questo parametro.

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