Partager via

New-TenantAllowBlockListItems

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

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande New-TenantAllowBlockListItems pour ajouter des entrées à la liste verte/bloquée du locataire dans le portail Microsoft 365 Defender.

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-TenantAllowBlockListItems
   -Entries <String[]>
   -ListType <ListType>
   [-ExpirationDate <DateTime>]
   [-Allow]
   [-Block]
   [-ListSubType <ListSubType>]
   [-LogExtraDetails]
   [-Notes <String>]
   [-OutputJson]
   [-SubmissionID <String>]
   [<CommonParameters>]
New-TenantAllowBlockListItems
   -Entries <String[]>
   -ListType <ListType>
   [-NoExpiration]
   [-Allow]
   [-Block]
   [-ListSubType <ListSubType>]
   [-LogExtraDetails]
   [-Notes <String>]
   [-OutputJson]
   [-SubmissionID <String>]
   [<CommonParameters>]

Description

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

New-TenantAllowBlockListItems -ListType Url -Block -Entries ~contoso.com~

Cet exemple ajoute une entrée de bloc d’URL pour contoso.com et tous les sous-domaines (par exemple, contoso.com, www.contoso.com, xyz.abc.contoso.com et www.contoso.com/b). Étant donné que nous n’avons pas utilisé les paramètres ExpirationDate ou NoExpiration, l’entrée expire au bout de 30 jours.

Exemple 2

New-TenantAllowBlockListItems -ListType FileHash -Block -Entries "768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3","2c0a35409ff0873cfa28b70b8224e9aca2362241c1f0ed6f622fef8d4722fd9a" -NoExpiration

Cet exemple ajoute une entrée de bloc de fichiers pour les fichiers spécifiés qui n’expire jamais.

Exemple 3

New-TenantAllowBlockListItems -Allow -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -NoExpiration

Cet exemple ajoute une entrée d’autorisation d’URL pour l’URL de simulation de hameçonnage tierce spécifiée sans expiration. Pour plus d’informations, consultez Configurer la remise de simulations d’hameçonnage tierces aux utilisateurs et de messages non filtrés aux boîtes aux lettres SecOps.

Paramètres

-Allow

Le commutateur Autoriser spécifie que vous créez une entrée d’autorisation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous ne pouvez pas utiliser ce commutateur avec le commutateur Bloquer.

Remarque : consultez Autoriser les entrées dans la liste verte/bloquée du locataire avant d’essayer de créer une entrée d’autorisation.

Vous pouvez également utiliser des entrées d’autorisation pour les URL de simulation de hameçonnage tierces sans expiration. Pour plus d’informations, consultez Configurer la remise de simulations d’hameçonnage tierces aux utilisateurs et de messages non filtrés aux boîtes aux lettres SecOps.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Block

Le commutateur Autoriser spécifie que vous créez une entrée de bloc. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous ne pouvez pas utiliser ce commutateur avec le commutateur Autoriser.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Entries

Le paramètre Entries spécifie les valeurs que vous souhaitez ajouter à la liste verte/bloquée du locataire en fonction de la valeur du paramètre ListType :

  • FileHash : utilisez la valeur de hachage SHA256 du fichier. Dans Windows, vous pouvez trouver la valeur de hachage SHA256 en exécutant la commande suivante dans une invite de commandes : certutil.exe -hashfile "<Path>\<Filename>" SHA256. Un exemple de valeur est 768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3.
  • Expéditeur : valeur de domaine ou d’adresse e-mail. Par exemple : contoso.com ou michelle@contoso.com.
  • URL : utilisez des adresses ou des noms d’hôte IPv4 ou IPv6. Les caractères génériques (* et ~) sont pris en charge dans les noms d’hôte. Les protocoles, les ports TCP/UDP ou les informations d’identification utilisateur ne sont pas pris en charge. Pour plus d’informations, consultez Syntaxe d’URL pour la liste verte/bloquée du locataire.

Pour entrer plusieurs valeurs, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Pour les expéditeurs, les fichiers et les URL, le nombre maximal d’entrées autorisées pour chaque type est de 500, et le nombre maximal d’entrées de bloc pour chaque type est de 500 (1 000 entrées au total pour chaque type).

Le nombre maximal de caractères dans une entrée de fichier est de 64 et le nombre maximal de caractères dans une entrée d’URL est de 250.

Vous ne pouvez pas combiner les types valeur (fichier, expéditeur ou URL) ou autoriser et bloquer les actions dans la même commande.

Dans la plupart des cas, vous ne pouvez pas modifier les valeurs d’URL, de fichier ou d’expéditeur après avoir créé l’entrée. La seule exception est l’autorisation des entrées d’URL pour les simulations de hameçonnage (ListType = URL, ListSubType = AdvancedDelivery).

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ExpirationDate

Le paramètre ExpirationDate filtre les résultats par date d’expiration en temps universel coordonné (UTC).

Pour spécifier une valeur date/heure pour ce paramètre, utilisez l’une des options suivantes :

  • Spécifiez la valeur de date/heure au format UTC : Par exemple, "2021-05-06 14:30:00z".
  • Spécifiez la valeur de date/heure en tant que formule qui convertit la date/heure de votre fuseau horaire local au format UTC : par exemple, (Get-Date "5/6/2020 9:30 AM").ToUniversalTime(). Pour plus d’informations, consultez Get-Date.

Vous ne pouvez pas utiliser ce paramètre avec le commutateur NoExpiration.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ListSubType

Le paramètre ListSubType spécifie le sous-type de cette entrée. Les valeurs valides sont les suivantes :

Type:ListSubType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ListType

Le paramètre ListType spécifie le type d’entrée à ajouter. Les valeurs valides sont les suivantes :

  • FileHash
  • Expéditeur
  • Url
Type:ListType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-LogExtraDetails

{{ Fill LogExtraDetails Description }}

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

-NoExpiration

Le commutateur NoExpiration spécifie que l’entrée ne doit jamais expirer. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur peut être utilisé dans les scénarios suivants :

  • Avec le commutateur Bloquer.
  • Avec le commutateur Allow, où la valeur du paramètre ListType est URL et la valeur du paramètre ListSubType est AdvancedDelivery.

Vous ne pouvez pas utiliser ce commutateur avec le paramètre ExpirationDate.

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

-Notes

Le paramètre Notes spécifie des informations supplémentaires sur l’objet. Si la valeur contient des espaces, placez-la entre guillemets (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-OutputJson

Le commutateur OutputJson spécifie s’il faut retourner toutes les entrées dans une seule valeur JSON. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous utilisez ce commutateur pour empêcher l’arrêt de la commande sur la première entrée qui contient une erreur de syntaxe.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-SubmissionID

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection