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 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" -NoExpirationCet 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 -NoExpirationCet 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 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 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 :
- AdvancedDelivery : utilisez cette valeur pour les URL de simulation de hameçonnage. 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.
- Locataire : il s’agit de la valeur par défaut.
| 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 |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour