Set-QuarantinePermissions

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Nota: invece di usare questo cmdlet per impostare le autorizzazioni dei criteri di quarantena, è consigliabile usare il parametro EndUserQuarantinePermissionsValue nei cmdlet New-QuarantinePolicy e Set-QuarantinePolicy.

Usare il cmdlet Set-QuarantinePermissions per modificare gli oggetti delle autorizzazioni di quarantena creati dal New-QuarantinePermissions e archiviati come variabile nella sessione di PowerShell corrente. Usare la variabile come valore per il parametro EndUserQuarantinePermission nei cmdlet di New-QuarantinePolicy o Set-QuarantinePolicy nella stessa sessione di PowerShell.

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

Sintassi

Default (Impostazione predefinita)

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

Descrizione

Per visualizzare il valore corrente dell'oggetto permissions che si desidera modificare, eseguire il nome della variabile come comando. Ad esempio, eseguire il comando $Perms per visualizzare le autorizzazioni dei criteri di quarantena archiviate nella $Perms variabile.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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 dei criteri di quarantena nella variabile in uscita $Perms creata in precedenza usando il cmdlet New-QuarantinePermissions nella stessa sessione di PowerShell (la $Perms variabile è ancora disponibile e popolata).

Nella stessa sessione di PowerShell è possibile utilizzare $Perms il valore del parametro EndUserQuarantinePermissions in un comando New-QuarantinePolicy o Set-QuarantinePolicy.

Parametri

-PermissionToAllowSender

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PermissionToBlockSender consente di specificare se gli utenti possono aggiungere il mittente dei messaggi in quarantena al proprio elenco Mittenti attendibili. I valori validi sono:

  • $true: l'opzione Consenti mittente è disponibile per i messaggi interessati in quarantena.
  • $false: L'opzione Consenti mittente non è disponibile per i messaggi interessati in quarantena. Questo è il valore predefinito.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PermissionToBlockSender

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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

  • $true: Blocca mittente è disponibile nelle notifiche in quarantena per i messaggi interessati, mentre Blocca mittente è disponibile per i messaggi interessati in quarantena.
  • $false: Blocca mittente non è disponibile nelle notifiche in quarantena per i messaggi interessati e Blocca mittente non è disponibile per i messaggi interessati in quarantena. Questo è il valore predefinito.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PermissionToDelete

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PermissionToDelete consente di specificare se gli utenti sono autorizzati a eliminare i messaggi dalla quarantena. I valori validi sono:

  • $true: Elimina messaggi ed Elimina dalla quarantena sono disponibili per i messaggi interessati in quarantena.
  • $false: Elimina messaggi ed Elimina dalla quarantena non sono disponibili per i messaggi interessati in quarantena. Questo è il valore predefinito.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PermissionToDownload

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PermissionToDownload consente di specificare se gli utenti possono 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 sulle azioni disponibili nelle notifiche o nella quarantena per i messaggi interessati. Gli utenti finali non possono scaricare i messaggi in quarantena.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:4
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PermissionToPreview

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PermissionToPreview consente di specificare se gli utenti sono autorizzati a visualizzare in anteprima i messaggi in quarantena. I valori validi sono:

  • $true: l'anteprima del messaggio è disponibile per i messaggi interessati in quarantena.
  • $false: L'anteprima del messaggio non è disponibile per i messaggi interessati in quarantena. Questo è il valore predefinito.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:5
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PermissionToRelease

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PermissionToRelease consente di specificare se gli utenti sono autorizzati a rilasciare direttamente i messaggi interessati dalla quarantena. I valori validi sono:

  • $true: Rilascia è disponibile nelle notifiche di quarantena per i messaggi interessati e Rilascia (e-mail di rilascio) è disponibile per i messaggi interessati in quarantena.
  • $false: Il messaggio di rilascio non è disponibile nelle notifiche di quarantena per i messaggi interessati e i messaggi di posta elettronica di rilascio e rilascio non sono disponibili per i messaggi interessati in quarantena.

Non impostare questo parametro e il parametro PermissionToRequestRelease su $true. Imposta un parametro su $true e l'altro su $false o imposta entrambi i parametri su $false.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:6
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PermissionToRequestRelease

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PermissionToRequestRelease consente di specificare se gli utenti sono autorizzati a richiedere che i messaggi vengano rilasciati dalla quarantena. La richiesta deve essere approvata da un amministratore. I valori validi sono i seguenti:

  • $true: La richiesta di rilascio è disponibile nelle notifiche di quarantena per i messaggi interessati e la richiesta di rilascio è disponibile per i messaggi interessati in quarantena.
  • $false: La richiesta di rilascio non è disponibile nelle notifiche di quarantena per i messaggi interessati e la richiesta di rilascio non è disponibile per i messaggi interessati in quarantena.

Non impostare questo parametro e il parametro PermissionRelease su $true. Imposta un parametro su $true e l'altro su $false o imposta entrambi i parametri su $false.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:7
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PermissionToViewHeader

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PermissionToViewHeader consente di specificare se gli utenti sono autorizzati a 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 sulle azioni disponibili nelle notifiche di quarantena o nella quarantena per i messaggi interessati. L'intestazione Visualizza messaggio è sempre disponibile per i messaggi interessati in quarantena.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:8
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-QuarantinePermissionsObject

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro QuarantinePermissionsObject consente di specificare la variabile esistente che contiene le autorizzazioni di quarantena che si desidera modificare. Ad esempio, se in precedenza è stato eseguito il comando $Perms = New-QuarantinePermissions <permissions>, utilizzare il valore $Perms per questo parametro.

Proprietà dei parametri

Tipo:QuarantinePermissions
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:9
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.