Partager via

Set-HostedConnectionFilterPolicy

Module:
Exchange PowerShell

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez la cmdlet Set-HostedConnectionFilterPolicy pour modifier les paramètres des stratégies de connexion dans votre organisation en nuage.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

Default (Par défaut) 

Set-HostedConnectionFilterPolicy
    [-Identity] <HostedConnectionFilterPolicyIdParameter>
    [-AdminDisplayName <String>]
    [-ConfigurationXmlRaw <String>]
    [-Confirm]
    [-EnableSafeList <Boolean>]
    [-IPAllowList <MultiValuedProperty>]
    [-IPBlockList <MultiValuedProperty>]
    [-MakeDefault]
    [-WhatIf]
    [<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

Set-HostedConnectionFilterPolicy "Default" -IPAllowList 192.168.1.10,192.168.1.23 -IPBlockList 10.10.10.0/25,172.17.17.0/24

Cet exemple modifie la stratégie de filtre de connexion nommée Default avec les paramètres suivants :

  • Les messages provenant de 192.168.1.10 et 192.168.1.23 ne sont jamais identifiés comme courrier indésirable.
  • Les messages de 10.10.10.0/25 et 172.17.17.0/24 sont toujours identifiés comme courrier indésirable.

Exemple 2

Set-HostedConnectionFilterPolicy "Default" -IPAllowList @{Add="192.168.2.10","192.169.3.0/24","192.168.4.1-192.168.4.5"; Remove="192.168.1.10"}

Cet exemple modifie la stratégie de filtre de connexion nommée Default avec les paramètres suivants :

  • Les adresses IP suivantes sont ajoutées aux valeurs existantes dans la liste d’adresses IP autorisées : 192.168.2.10, 192.169.3.0/24 et 192.168.4.1-192.168.4.5.
  • L'adresse IP 192.168.1.10 est supprimée des valeurs existant dans la liste IP autorisée.

Paramètres

-AdminDisplayName

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre AdminDisplayName spécifie une description pour la stratégie. Si la valeur contient des espaces, placez-la entre guillemets ("). La longueur maximale est de 255 caractères.

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

-ConfigurationXmlRaw

Applicable : Exchange Online, 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

-Confirm

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

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
Alias:Cf

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

-EnableSafeList

Applicable : Exchange Online, 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:Boolean
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

-Identity

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre Identity spécifie la stratégie de filtre de connexion que vous souhaitez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

En règle générale, vous n’avez qu’une seule stratégie de filtre de connexion : la stratégie par défaut nommée Default.

Propriétés du paramètre

Type:HostedConnectionFilterPolicyIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IPAllowList

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre IPAllowList désigne les adresses IP pour lesquelles les messages sont toujours autorisés. Les messages provenant des adresses IP que vous spécifiez ne sont pas identifiés comme courrier indésirable, malgré les autres caractéristiques de courrier indésirable des messages. Les valeurs valides sont les suivantes :

  • Adresse IP unique : par exemple, 192.168.1.1.
  • Plage d’adresses IP : vous pouvez utiliser une plage d’adresses IP, par exemple 192.168.0.1-192.168.0.254. Le nombre maximal d’adresses dans la plage est de 256.
  • Plage d'adresses IP du routage interdomaine sans classe (CIDR) : par exemple, 192.168.0.1/25. Les valeurs de masque de sous-réseau valides sont de /24 à /32.

Vous pouvez spécifier plusieurs adresses IP du même type, séparées par des virgules. Par exemple : SingleIP1, SingleIP2,...SingleIPN ou CIDRIP1,CIDRIP2,...CIDRIPN. Pour spécifier plusieurs adresses IP de types différents en même temps, vous devez utiliser la syntaxe de propriété à valeurs multiples suivante : @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Remarque : les plages IPv6 ne sont pas prises en charge.

Propriétés du paramètre

Type:MultiValuedProperty
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

-IPBlockList

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le paramètre IPBlockList désigne les adresses IP pour lesquelles les messages ne sont jamais autorisés. Les messages provenant d'adresses IP que vous indiquez sont bloqués et ne sont pas analysés. Les valeurs valides sont les suivantes :

  • Adresse IP unique : par exemple, 192.168.1.1.
  • Plage d’adresses IP : vous pouvez utiliser une plage d’adresses IP, par exemple 192.168.0.1-192.168.0.254. Le nombre maximal d’adresses dans la plage est de 256.
  • Plage d'adresses IP du routage interdomaine sans classe (CIDR) : par exemple, 192.168.0.1/25. Les valeurs de masque de sous-réseau valides sont de /24 à /32.

Vous pouvez spécifier plusieurs adresses IP du même type, séparées par des virgules. Par exemple : SingleIP1, SingleIP2,...SingleIPN ou CIDRIP1,CIDRIP2,...CIDRIPN. Pour spécifier plusieurs adresses IP de types différents en même temps, vous devez utiliser la syntaxe de propriété à valeurs multiples suivante : @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Remarque : les plages IPv6 ne sont pas prises en charge.

Propriétés du paramètre

Type:MultiValuedProperty
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

-MakeDefault

Applicable : Exchange Online, 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: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

-WhatIf

Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. 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
Alias:Wi

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.

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.