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 des utilisateurs autorisés/bloqués du client 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). Comme 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 blocage de fichier 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 d’hameçonnage non-Microsoft spécifiée sans expiration. Pour plus d’informations, consultez Configurer la stratégie de distribution avancée pour les simulations d’hameçonnage non-Microsoft et la remise de courrier électronique aux boîtes aux lettres SecOps.
Exemple 4
New-TenantAllowBlockListItems -Allow -ListType Url -Entries abcd.fabrikam.com -RemoveAfter 45
Cet exemple ajoute une entrée d’autorisation d’URL pour le domaine spécifié avec une expiration de 45 jours après la date de la dernière utilisation. Cette autorisation autorise les URL identifiées comme en bloc, courrier indésirable, courrier indésirable à haut niveau de confiance et hameçonnage (et non hameçonnage à haut niveau de confiance).
Pour les URL identifiées comme programmes malveillants ou hameçonnage à haut niveau de fiabilité, vous devez soumettre les URL que Microsoft autorise. Pour obtenir des instructions, consultez Signaler à Microsoft les URL correctes.
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 Autoriser. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous ne pouvez pas utiliser ce commutateur avec le commutateur de blocage.
Remarque : avant d’essayer de créer une entrée d’autorisation /d’autorisation du client, voir Autoriser les entrées dans la liste d’autorisation/de blocage du client.
Vous pouvez également utiliser des entrées d’autorisation pour les URL de simulation d’hameçonnage non Microsoft sans expiration. Pour plus d’informations, consultez Configurer la stratégie de distribution avancée pour les simulations d’hameçonnage non-Microsoft et la remise de courrier électronique 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 d’autorisation/de blocage du client en fonction de la valeur du paramètre ListType :
FileHash : utilise 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. Exemple de valeur est768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3.Expéditeur : valeur de domaine ou d’adresse e-mail. Par exemple :
contoso.comoumichelle@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 URL pour la liste verte/rouge du client.
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 à compression nulle (par exemple, 2001 :db8 ::1 pour 2001:0db8:0000:0000:0000:0000:0000:0001).
• La plage CIDR IPv6 est comprise entre 1 et 128 (par exemple, 2001:0db8 ::/32).
Pour saisir plusieurs valeurs, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
Limites de saisie 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 bloquées est de 500.
- Organisations disposant de Defender pour Office 365 Plan 1 : le nombre maximal d’entrées autorisées est de 1000 et le nombre maximal d’entrées bloquées est de 1000.
- Organisations disposant de Defender pour Office 365 Plan 2 : Le nombre maximal d’entrées autorisées est de 5000 et le nombre maximal d’entrées bloquées est de 10000.
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 mélanger des types de valeurs (expéditeur, URL, fichier ou adresse IP) ou autoriser et bloquer des 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 DateExpiration 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 date/heure UTC : Par exemple,
"2021-05-06 14:30:00z". - Spécifiez la valeur date/heure sous la forme d’une formule qui convertit la date/heure de votre fuseau horaire local en 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 :
- AdvancedDelivery : utilisez cette valeur pour les URL de simulation d’hameçonnage. Pour plus d’informations, consultez Configurer la stratégie de distribution avancée pour les simulations d’hameçonnage non-Microsoft et la remise de courrier électronique aux boîtes aux lettres SecOps.
- Client : cette valeur est la valeur par défaut.
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
{{ Remplir la description LogExtraDetails }}
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 Block.
- Avec le commutateur Autoriser, où la valeur du paramètre ListType est URL et la valeur du paramètre ListSubType est AdvancedDelivery.
- Avec le commutateur Autoriser, 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 ("). Si la valeur contient des guillemets, ajoutez une barre oblique inverse ( \ ) avant les 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.
Ce commutateur permet d’empêcher l’arrêt de la commande à 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 dernière date utilisée pour autoriser l’entrée. La propriété LastUsedDate est remplie lorsque la mauvaise entité dans l’entrée autoriser est rencontrée par le système de filtrage pendant le flux de courrier ou le moment du clic. L’entrée Autoriser est conservée pendant 45 jours une fois 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 Autoriser 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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.