Partager via


New-TenantAllowBlockListItems

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 des locataires dans le portail Microsoft Defender.

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

Syntaxe

Expiration

New-TenantAllowBlockListItems
    -Entries <String[]>
    -ListType <ListType>
    [-ExpirationDate <DateTime>]
    [-Allow]
    [-Block]
    [-ListSubType <ListSubType>]
    [-LogExtraDetails]
    [-Notes <String>]
    [-OutputJson]
    [-RemoveAfter <Int32>]
    [-SubmissionID <String>]
    [<CommonParameters>]

NoExpiration

New-TenantAllowBlockListItems
    -Entries <String[]>
    -ListType <ListType>
    [-NoExpiration]
    [-Allow]
    [-Block]
    [-ListSubType <ListSubType>]
    [-LogExtraDetails]
    [-Notes <String>]
    [-OutputJson]
    [-RemoveAfter <Int32>]
    [-SubmissionID <String>]
    [<CommonParameters>]

Description

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

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 non-Microsoft spécifiée sans expiration. Pour plus d’informations, consultez Configurer la stratégie de remise avancée pour les simulations d’hameçonnage non-Microsoft et la remise d’e-mails aux boîtes aux lettres SecOps.

Exemple 4

New-TenantAllowBlockListItems -Allow -ListType Url -Entries abcd.fabrikam.com -RemoveAfter 45

Cet exemple montre comment ajouter une entrée d’autorisation d’URL pour le domaine spécifié dont l’expiration est de 45 jours après la date de dernière utilisation. L’entrée autorise les URL identifiées comme étant en bloc, courrier indésirable, courrier indésirable à haut niveau de confiance et hameçonnage (hameçonnage à confiance élevée).

Pour les URL identifiées comme des programmes malveillants ou des hameçonnages à haut niveau de confiance, vous devez envoyer les URL Microsoft pour créer des entrées d’autorisation. Pour obtenir des instructions, consultez Signaler des URL correctes à Microsoft.

Paramètres

-Allow

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

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 non-Microsoft sans expiration. Pour plus d’informations, consultez Configurer la stratégie de remise avancée pour les simulations d’hameçonnage non-Microsoft et la remise d’e-mails aux boîtes aux lettres SecOps.

Propriétés du paramètre

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

Jeux de paramètres

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

-Block

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

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.

Propriétés du paramètre

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

Jeux de paramètres

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

-Entries

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

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. Vous pouvez trouver la valeur de hachage SHA256 en exécutant la commande suivante dans PowerShell : Get-FileHash -Path "<Path>\<Filename>" -Algorithm 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.

  • IP : adresses IPv6 uniquement :

    • Adresses IPv6 uniques au format hexadécimal deux-points (par exemple, 2001:0db8:85a3:0000:0000:8a2e :0370:7334).

    • Adresses IPv6 uniques au format de compression zéro (par exemple, 2001 :db8 ::1 pour 2001:0db8:0000:0000:0000:0000:0000:0000:0001).

    • Les plages CIDR IPv6 sont comprises entre 1 et 128 (par exemple, 2001:0db8 ::/32).

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

Limites d’entrée pour chaque sous-type de liste (expéditeur, URL, fichier ou adresse IP) :

  • Organisations sans Microsoft Defender pour Office 365 : le nombre maximal d’entrées autorisées est de 500 et le nombre maximal d’entrées de bloc est de 500.
  • Organisations avec Defender pour Office 365 Plan 1 : le nombre maximal d’entrées autorisées est de 1 000 et le nombre maximal d’entrées de bloc est de 1 000.
  • Organisations avec Defender pour Office 365 Plan 2 : le nombre maximal d’entrées autorisées est de 5 000 et le nombre maximal d’entrées de bloc est de 10 000.

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 (expéditeur, URL, fichier ou adresse IP) ou autoriser et bloquer les actions dans la même commande.

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

Propriétés du paramètre

Type:

String[]

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

Jeux de paramètres

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

-ExpirationDate

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

Le paramètre ExpirationDate définit la date d’expiration de l’entrée 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 les paramètres NoExpiration ou RemoveAfter.

Propriétés du paramètre

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

Jeux de paramètres

Expiration
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ListSubType

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

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

Propriétés du paramètre

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

Jeux de paramètres

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

-ListType

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

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

  • FileHash
  • Expéditeur
  • Url
  • IP

Propriétés du paramètre

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

Jeux de paramètres

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

-LogExtraDetails

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

{{ Fill LogExtraDetails Description }}

Propriétés du paramètre

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

Jeux de paramètres

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

-NoExpiration

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

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.
  • Avec le commutateur Allow où la valeur du paramètre ListType est IP.

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

Propriétés du paramètre

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

Jeux de paramètres

NoExpiration
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Notes

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

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

Propriétés du paramètre

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

Jeux de paramètres

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

-OutputJson

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

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.

Propriétés du paramètre

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

Jeux de paramètres

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

-RemoveAfter

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

Le paramètre RemoveAfter active la fonctionnalité Supprimer>45 jours après la date de dernière utilisation pour une entrée d’autorisation. La propriété LastUsedDate est remplie lorsque l’entité incorrecte dans l’entrée d’autorisation est rencontrée par le système de filtrage pendant le flux de messagerie ou l’heure du clic. L’entrée d’autorisation est conservée pendant 45 jours après que le système de filtrage a déterminé que l’entité est propre.

La seule valeur valide pour ce paramètre est 45.

Vous pouvez utiliser ce paramètre avec le commutateur Allow lorsque la valeur du paramètre ListType est Sender, FileHash ou Url.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres ExpirationDate ou NoExpirationDate.

Propriétés du paramètre

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

Jeux de paramètres

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

-SubmissionID

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

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

Propriétés du paramètre

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

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
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.