Partager via

Set-TenantAllowBlockListItems

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Online, Security & Compliance, Exchange Online Protection

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/2021

Cet 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 :

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