Partager via


Set-QuarantinePermissions

Cette cmdlet est disponible uniquement dans le service cloud.

Remarque : Au lieu d’utiliser cette applet de commande pour définir des autorisations de stratégie de mise en quarantaine, nous vous recommandons d’utiliser le paramètre EndUserQuarantinePermissionsValue sur les applets de commande New-QuarantinePolicy et Set-QuarantinePolicy.

Utilisez l’applet de commande Set-QuarantinePermissions pour modifier les objets d’autorisations de mise en quarantaine créés par le New-QuarantinePermissions et stockés en tant que variable dans la session PowerShell active. Vous utilisez la variable comme valeur pour le paramètre EndUserQuarantinePermission sur les applets de commande New-QuarantinePolicy ou Set-QuarantinePolicy dans la même session PowerShell.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

Default (Par défaut)

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

Description

Pour afficher la valeur actuelle de l’objet d’autorisations que vous souhaitez modifier, exécutez le nom de la variable en tant que commande. Par exemple, exécutez la commande $Perms pour voir les autorisations de stratégie de mise en quarantaine stockées dans la $Perms variable .

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

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

Cet exemple modifie les autorisations de stratégie de mise en quarantaine dans la variable de $Perms sortie qui a été créée précédemment à l’aide de l’applet de commande New-QuarantinePermissions dans la même session PowerShell (la $Perms variable est toujours disponible et remplie).

Dans la même session PowerShell, vous pouvez utiliser $Perms pour la valeur du paramètre EndUserQuarantinePermissions dans une commande New-QuarantinePolicy ou Set-QuarantinePolicy.

Paramètres

-PermissionToAllowSender

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PermissionToBlockSender spécifie si les utilisateurs sont autorisés à ajouter l’expéditeur du message mis en quarantaine à leur liste d’expéditeurs approuvés. Les valeurs valides sont les suivantes :

  • $true : Autoriser l’expéditeur est disponible pour les messages affectés en quarantaine.
  • $false : Autoriser l’expéditeur n’est pas disponible pour les messages affectés en quarantaine. Cette valeur est la valeur par défaut.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PermissionToBlockSender

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PermissionToBlockSender spécifie si les utilisateurs sont autorisés à ajouter l’expéditeur du message en quarantaine à leur liste d’expéditeurs bloqués. Les valeurs valides sont les suivantes :

  • $true : l’expéditeur de blocage est disponible dans les notifications de mise en quarantaine pour les messages affectés, et l’expéditeur de blocage est disponible pour les messages affectés en quarantaine.
  • $false : l’expéditeur de blocage n’est pas disponible dans les notifications de mise en quarantaine pour les messages affectés, et l’expéditeur de blocage n’est pas disponible pour les messages affectés en quarantaine. Cette valeur est la valeur par défaut.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PermissionToDelete

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PermissionToDelete spécifie si les utilisateurs sont autorisés à supprimer des messages de la quarantaine. Les valeurs valides sont les suivantes :

  • $true : Supprimer les messages et Supprimer de la quarantaine sont disponibles pour les messages affectés en quarantaine.
  • $false : Les messages Supprimer et Supprimer de la quarantaine ne sont pas disponibles pour les messages affectés en quarantaine. Cette valeur est la valeur par défaut.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PermissionToDownload

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PermissionToDownload spécifie si les utilisateurs sont autorisés à télécharger des messages à partir de la quarantaine. Les valeurs valides sont les suivantes :

  • $true : l’autorisation est activée.
  • $false : l’autorisation est désactivée. Cette valeur est la valeur par défaut.

Actuellement, cette valeur n’a aucun effet sur les actions disponibles dans les notifications de mise en quarantaine ou la mise en quarantaine des messages affectés. Les utilisateurs finaux ne peuvent pas télécharger les messages mis en quarantaine.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:4
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PermissionToPreview

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PermissionToPreview spécifie si les utilisateurs sont autorisés à afficher un aperçu des messages mis en quarantaine. Les valeurs valides sont les suivantes :

  • $true : le message en préversion est disponible pour les messages affectés en quarantaine.
  • $false : le message en préversion n’est pas disponible pour les messages affectés en quarantaine. Cette valeur est la valeur par défaut.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:5
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PermissionToRelease

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PermissionToRelease spécifie si les utilisateurs sont autorisés à libérer directement les messages affectés de la mise en quarantaine. Les valeurs valides sont les suivantes :

  • $true : la mise en production est disponible dans les notifications de mise en quarantaine pour les messages affectés, et La version (e-mail de mise en production) est disponible pour les messages affectés en quarantaine.
  • $false : le message de mise en production n’est pas disponible dans les notifications de mise en quarantaine pour les messages affectés, et les e-mails de mise en production et de mise en production ne sont pas disponibles pour les messages affectés en quarantaine.

Ne définissez pas ce paramètre et le paramètre PermissionToRequestRelease sur $true. Définissez un paramètre sur $true et l’autre sur $false, ou définissez les deux paramètres sur $false.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:6
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PermissionToRequestRelease

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PermissionToRequestRelease spécifie si les utilisateurs sont autorisés à demander la libération des messages de la quarantaine. La demande doit être approuvée par un administrateur. Les valeurs valides sont les suivantes :

  • $true : la mise en production de la demande est disponible dans les notifications de mise en quarantaine pour les messages affectés, et la mise en production de la demande est disponible pour les messages concernés en quarantaine.
  • $false : La mise en production de la demande n’est pas disponible dans les notifications de mise en quarantaine pour les messages affectés, et la mise en production de la demande n’est pas disponible pour les messages affectés en quarantaine.

Ne définissez pas ce paramètre et le paramètre PermissionRelease sur $true. Définissez un paramètre sur $true et l’autre sur $false, ou définissez les deux paramètres sur $false.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:7
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PermissionToViewHeader

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre PermissionToViewHeader spécifie si les utilisateurs sont autorisés à afficher les en-têtes de messages mis en quarantaine. Les valeurs valides sont les suivantes :

  • $true : l’autorisation est activée.
  • $false : l’autorisation est désactivée. Cette valeur est la valeur par défaut.

Actuellement, cette valeur n’a aucun effet sur les actions disponibles dans les notifications de mise en quarantaine ou la mise en quarantaine des messages affectés. Afficher l’en-tête de message est toujours disponible pour les messages affectés en quarantaine.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:8
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-QuarantinePermissionsObject

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre QuarantinePermissionsObject spécifie la variable existante qui contient les autorisations de mise en quarantaine que vous souhaitez modifier. Par exemple, si vous avez précédemment exécuté la commande $Perms = New-QuarantinePermissions <permissions>, utilisez la valeur $Perms de ce paramètre.

Propriétés du paramètre

Type:QuarantinePermissions
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:9
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.