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 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
Set-TenantAllowBlockListItems
-Ids <String[]>
-ListType <ListType>
[-Allow]
[-Block]
[-ExpirationDate <DateTime>]
[-ListSubType <ListSubType>]
[-NoExpiration]
[-Notes <String>]
[-OutputJson]
[<CommonParameters>] Set-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-Allow]
[-Block]
[-ExpirationDate <DateTime>]
[-ListSubType <ListSubType>]
[-NoExpiration]
[-Notes <String>]
[-OutputJson]
[<CommonParameters>] Description
Dans la plupart des cas, vous ne pouvez pas modifier les valeurs d’URL, de fichier ou d’expéditeur d’une entrée existante. La seule exception est l’autorisation des entrées d’URL pour les simulations de hameçonnage (Action = Allow, ListType = URL et ListSubType = AdvancedDelivery). Pour plus d’informations sur l’autorisation des URL pour les simulations de hameçonnage, consultez Configurer la remise de simulations d’hameçonnage tierces aux utilisateurs et des messages non filtrés aux boîtes aux lettres SecOps.
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
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/2021Cet exemple modifie la date d’expiration de l’entrée d’autorisation d’URL pour l’URL de simulation de hameçonnage tierce spécifiée.
Paramètres
-Allow
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.
| 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 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.
| 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 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.
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 (fichier, expéditeur ou URL) ou autoriser et bloquer les actions dans la même commande.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Ids.
| 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 |
-Ids
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.
| 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 |
-ListSubType
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 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 que vous souhaitez modifier. Les valeurs valides sont les suivantes :
- FileHash
- Expéditeur
- Url
Utilisez le paramètre Entries ou Ids avec ce paramètre pour identifier l’entrée elle-même.
| 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 |
-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é avec des entrées de bloc ou avec des entrées d’url autorisées où 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 |
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