Set-TenantAllowBlockListItems
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande Set-TenantAllowBlockListItems pour modifier les entrées dans 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
Ids (Par défaut)
Set-TenantAllowBlockListItems
-Ids <String[]>
-ListType <ListType>
[-Allow]
[-Block]
[-ExpirationDate <DateTime>]
[-ListSubType <ListSubType>]
[-NoExpiration]
[-Notes <String>]
[-OutputJson]
[-RemoveAfter <Int32>]
[<CommonParameters>]
Entries
Set-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-Allow]
[-Block]
[-ExpirationDate <DateTime>]
[-ListSubType <ListSubType>]
[-NoExpiration]
[-Notes <String>]
[-OutputJson]
[-RemoveAfter <Int32>]
[<CommonParameters>]
Description
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). Pour plus d’informations sur l’autorisation des URL pour les simulations de hameçonnage, 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.
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
Set-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSRAAAA" -ExpirationDate (Get-Date "5/30/2021 9:30 AM").ToUniversalTime()
Cet exemple montre comment modifier la date d’expiration de l’entrée spécifiée.
Exemple 2
Set-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -ExpirationDate 9/11/2021
Cet exemple modifie la date d’expiration de l’entrée d’autorisation d’URL pour l’URL de simulation de hameçonnage non-Microsoft spécifiée.
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 modifiez une entrée d’autorisation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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 Bloquer spécifie que vous modifiez une entrée de bloc. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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 entrées que vous souhaitez modifier en fonction de la valeur du paramètre ListType. Les valeurs valides sont les suivantes :
- FileHash : valeur de hachage de fichier SHA256 exacte.
- Domaines et adresses e-mail de l’expéditeur : valeur exacte du domaine ou de l’adresse e-mail.
- Url : valeur exacte de l’URL.
- IP : adresses IPv6 uniquement. Adresses IPv6 uniques au format deux-points hexadécimal ou de compression zéro, ou plages IPv6 CIDR comprises entre 1 et 128.
Cette valeur est affichée dans la propriété Value de l’entrée dans la sortie de l’applet de commande Get-TenantAllowBlockListItems.
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.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Ids.
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
Entries
| 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 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 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
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Ids
Applicable : Exchange Online, Sécurité & Conformité, Module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Ids spécifie les entrées que vous souhaitez modifier. Cette valeur est affichée dans la propriété Identity dans la sortie de l’applet de commande Get-TenantAllowBlockListItems.
Un exemple de valeur pour ce paramètre est RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Entries.
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
Ids
| Position: | Named |
| Obligatoire: | True |
| 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 en outre l’entrée que vous souhaitez modifier. 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 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.
- Locataire : 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 que vous souhaitez modifier. Les valeurs valides sont les suivantes :
- FileHash
- Expéditeur
- Url
- IP
Utilisez le paramètre Entries ou Ids avec ce paramètre pour identifier l’entrée elle-même.
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 |
-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é avec les types d’entrées suivants :
- Bloquer les entrées.
- URL autorise les entrées pour lesquelles la valeur du paramètre ListSubType est AdvancedDelivery.
- L’adresse IP autorise les entrées.
Vous ne pouvez pas utiliser ce commutateur avec le paramètre ExpirationDate.
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: | 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 ne pouvez pas utiliser ce paramètre avec les paramètres ExpirationDate ou NoExpirationDate.
Pour remplacer l’entrée d’autorisation par une valeur date/heure d’expiration statique qui ne dépend pas de la propriété LastUsedDate, exécutez une commande Set-TenantAllowBlockListItems avec le paramètre ExpirationDate.
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 |
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.