Set-QuarantinePermissions

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande Set-QuarantinePermissions pour modifier les objets d’autorisations de mise en quarantaine utilisés dans les balises de mise en quarantaine (applets de commande New-QuarantineTag ou Set-QuarantineTag). Cette applet de commande fonctionne uniquement sur les objets d’autorisation créés par l’applet de commande New-QuarantinePermissions et stockés dans une variable actuellement disponible dans la session Windows PowerShell.

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

Syntax

Set-QuarantinePermissions
   -QuarantinePermissionsObject <QuarantinePermissions>
   [-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 balise 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 cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été 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 balise de mise en quarantaine spécifiées dans l’objet d’autorisations de $Perms sortie créé précédemment dans la même session Windows PowerShell (la $Perms variable est toujours disponible et remplie).

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

Paramètres

-PermissionToBlockSender

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 : le bouton Bloquer l’expéditeur est inclus dans les notifications de mise en quarantaine de l’utilisateur final.
  • $false : le bouton Bloquer l’expéditeur n’est pas inclus dans les notifications de mise en quarantaine des utilisateurs finaux. Il s’agit de la valeur par défaut.
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

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 : le bouton Supprimer de la quarantaine est inclus dans les détails du message mis en quarantaine.
  • $false : le bouton Supprimer de la quarantaine n’est pas inclus dans les détails du message mis en quarantaine. Il s’agit de la valeur par défaut.
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

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. Il s’agit de la valeur par défaut.

Actuellement, cette valeur n’a aucun effet sur les boutons inclus dans les notifications de courrier indésirable de l’utilisateur final ou dans les détails des messages mis en quarantaine.

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

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 bouton Aperçu du message est inclus dans les détails du message mis en quarantaine.
  • $false : le bouton Aperçu du message n’est pas inclus dans les détails du message mis en quarantaine. Il s’agit de la valeur par défaut.
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

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

  • $true : le bouton Publier est inclus dans les notifications de courrier indésirable de l’utilisateur final, et le bouton Publier le message est inclus dans les détails du message mis en quarantaine.
  • $false : le bouton Publier n’est pas inclus dans les notifications de courrier indésirable de l’utilisateur final, et le bouton Publier le message n’est pas inclus dans les détails du message mis en quarantaine. Il s’agit de la valeur par défaut.

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.

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

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 : le bouton Publier est inclus dans les notifications de courrier indésirable de l’utilisateur final, et le bouton Publier le message est inclus dans les détails du message mis en quarantaine.
  • $false : le bouton Publier n’est pas inclus dans les notifications de courrier indésirable de l’utilisateur final, et le bouton Publier le message n’est pas inclus dans les détails du message mis en quarantaine. Il s’agit de la valeur par défaut.

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.

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

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. Il s’agit de la valeur par défaut.

Actuellement, cette valeur n’a aucun effet sur les boutons inclus dans les notifications de courrier indésirable de l’utilisateur final ou dans les détails des messages mis en quarantaine. Le bouton Afficher l’en-tête de message est toujours disponible dans les détails du message mis en quarantaine.

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

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

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