Partager via

New-QuarantinePermissions

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Online, Exchange Online Protection

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande New-QuarantinePermissions pour créer des objets d’autorisations de mise en quarantaine à utiliser avec l’applet de commande New-QuarantineTag.

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

Syntax

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

Description

La valeur par défaut des paramètres que vous n’utilisez pas est $false. Par conséquent, vous devez uniquement utiliser les paramètres (autorisations) que vous souhaitez définir sur $true.

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

$NoAccess = New-QuarantinePermissions

Cet exemple crée les mêmes autorisations que celles utilisées par le groupe Aucune autorisation d’accès dans les balises de mise en quarantaine dans security & Compliance. L’objet permissions est stocké dans la variable nommée $NoAccess.

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

Exemple 2

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

Cet exemple crée les mêmes autorisations que celles utilisées par le groupe Autorisations d’accès limité dans les balises de mise en quarantaine de la conformité de sécurité & . L’objet permissions est stocké dans la variable nommée $LimitedAccess.

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

Exemple 3

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

Cet exemple crée les mêmes autorisations que celles utilisées par le groupe Autorisations d’accès complet dans les balises de mise en quarantaine de la conformité de sécurité & . L’objet permissions est stocké dans la variable nommée $FullAccess.

Dans la même session Windows PowerShell, vous pouvez utiliser $FullAccess 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