Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Set-ClientAccessRule

 

S’applique à :Exchange Online

Dernière rubrique modifiée :2017-11-08

Utilisez la cmdlet Set-ClientAccessRule pour modifier les règles d’accès client existantes. Ces dernières vous permettent de contrôler l’accès à votre organisation en nuage en fonction des propriétés de la connexion.

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

Set-ClientAccessRule -Identity <ClientAccessRuleIdParameter> [-Action <AllowAccess | DenyAccess>] [-AnyOfAuthenticationTypes <MultiValuedProperty>] [-AnyOfClientIPAddressesOrRanges <MultiValuedProperty>] [-AnyOfProtocols <MultiValuedProperty>] [-AnyOfSourceTcpPortNumbers <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DatacenterAdminsOnly <SwitchParameter>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExceptAnyOfAuthenticationTypes <MultiValuedProperty>] [-ExceptAnyOfClientIPAddressesOrRanges <MultiValuedProperty>] [-ExceptAnyOfProtocols <MultiValuedProperty>] [-ExceptAnyOfSourceTcpPortNumbers <MultiValuedProperty>] [-ExceptUserIsMemberOf <MultiValuedProperty>] [-ExceptUsernameMatchesAnyOfPatterns <MultiValuedProperty>] [-Name <String>] [-Priority <Int32>] [-Scope <All | Users>] [-UserIsMemberOf <MultiValuedProperty>] [-UsernameMatchesAnyOfPatterns <MultiValuedProperty>] [-UserRecipientFilter <String>] [-WhatIf [<SwitchParameter>]]

Cet exemple ajoute la plage d’adresses IP 172.17.17.27/16 à la règle d’accès client existante nommée Autoriser IMAP4, sans que cela ait une incidence sur les valeurs d’adresses IP existantes.

Set-ClientAccessRule "Allow IMAP4" -AnyOfClientIPAddressesOrRanges @{Add="172.17.17.27/16"}

Les règles d’accès au client sont comme des règles de transport pour les connexions client à votre organisation. Vous utilisez des conditions et des exceptions pour identifier les connexions en fonction de l’utilisateur ou des propriétés du client ou de la connexion, et des actions qui déterminent quoi faire avec ces connexions.

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 nécessaires pour exécuter une cmdlet ou un paramètre dans votre organisation, consultez la rubrique Rechercher les autorisations requises pour exécuter les cmdlets Exchange.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.ClientAccessRuleIdParameter

Le paramètre Identity spécifie la règle d’accès client à modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie distinctement la règle d’accès client. Par exemple :

  • name

  • Nom unique

  • GUID

Action

Facultatif

Microsoft.Exchange.Data.ClientAccessRulesAction

Le paramètre Action spécifie l’action pour la règle d’accès client. Les valeurs valides pour ce paramètre sont AllowAccess et DenyAccess.

AnyOfAuthenticationTypes

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre AnyOfAuthenticationTypes spécifie une condition pour la règle d’accès client basée sur le type d’authentification du client.

Les valeurs valides pour ce paramètre sont les suivantes :

  • AdfsAuthentication

  • BasicAuthentication

  • CertificateBasedAuthentication

  • NonBasicAuthentication

  • OAuthAuthentication

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

AnyOfClientIPAddressesOrRanges

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre AnyOfClientIPAddressesOrRanges spécifie une condition pour la règle d’accès client qui est basée sur l’adresse IP du client. Les valeurs valides pour ce paramètre sont les suivantes :

  • Une adresse IP unique   Par exemple, 192.168.1.1.

  • Une plage d’adresses IP   Par exemple, 192.168.0.1-192.168.0.254.

  • Une adresse IP de routage interdomaine sans classe (CIDR)   Par exemple, 192.168.3.1/24.

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

AnyOfProtocols

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre AnyOfProtocols spécifie une condition pour la règle d’accès client basée sur le protocole du client.

Les valeurs valides pour ce paramètre sont les suivantes :

  • ExchangeActiveSync

  • ExchangeAdminCenter

  • ExchangeWebServices

  • IMAP4

  • OfflineAddressBook

  • OutlookAnywhere

  • OutlookWebApp

  • POP3

  • PowerShellWebServices

  • RemotePowerShell

  • REST

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

AnyOfSourceTcpPortNumbers

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre est réservé à l’usage interne chez Microsoft.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

DatacenterAdminsOnly

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est réservé à l’usage interne chez Microsoft.

Enabled

Facultatif

System.Boolean

Le paramètre Enabled indique si la règle d’accès client est activée ou désactivée. Les valeurs valides pour ce paramètre sont $true ou $false.

ExceptAnyOfAuthenticationTypes

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptAnyOfAuthenticationTypes spécifie une exception pour la règle d’accès client basée sur le type d’authentification du client.

Les valeurs valides pour ce paramètre sont les suivantes :

  • AdfsAuthentication

  • BasicAuthentication

  • CertificateBasedAuthentication

  • NonBasicAuthentication

  • OAuthAuthentication

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

ExceptAnyOfClientIPAddressesOrRanges

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptAnyOfClientIPAddressesOrRanges spécifie une exception pour la règle d’accès client qui est basée sur l’adresse IP du client. Les valeurs valides pour ce paramètre sont les suivantes :

  • Une adresse IP unique   Par exemple, 192.168.1.1.

  • Une plage d’adresses IP   Par exemple, 192.168.0.1-192.168.0.254.

  • Une adresse IP de routage interdomaine sans classe (CIDR)   Par exemple, 192.168.3.1/24.

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

ExceptAnyOfProtocols

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptAnyOfProtocols spécifie une exception pour la règle d’accès client basée sur le protocole du client.

Les valeurs valides pour ce paramètre sont les suivantes :

  • ExchangeActiveSync

  • ExchangeAdminCenter

  • ExchangeWebServices

  • IMAP4

  • OfflineAddressBook

  • OutlookAnywhere

  • OutlookWebApp

  • POP3

  • PowerShellWebServices

  • RemotePowerShell

  • REST

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

ExceptAnyOfSourceTcpPortNumbers

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre est réservé à l’usage interne chez Microsoft.

ExceptUserIsMemberOf

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre est réservé à l’usage interne chez Microsoft.

ExceptUsernameMatchesAnyOfPatterns

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ExceptUsernameMatchesAnyOfPatterns spécifie une exception pour la règle d’accès client qui est basée sur le nom de compte de l’utilisateur. Ce paramètre accepte du texte et le caractère générique (*). Les caractères non alphanumériques n’exigent pas de caractère d’échappement.

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

name

Facultatif

System.String

Le paramètre Name spécifie un nom unique pour la règle d’accès client.

Priority

Facultatif

System.Int32

Le paramètre Priority spécifie une valeur de priorité pour la règle d’accès client. Une valeur entière inférieure indique une priorité plus élevée et une règle de priorité plus élevée est évaluée avant une règle de priorité plus faible. La valeur par défaut est 1.

Scope

Facultatif

Microsoft.Exchange.Data.ClientAccessRulesScope

La Scope paramètre spécifie l’étendue de la règle d’accès client. Les valeurs valides sont :

  • Users   La règle s’applique uniquement aux connexions des utilisateurs finaux.

  • All   La règle s’applique à toutes les connexions (utilisateurs finaux et les applications de couche intermédiaire).

UserIsMemberOf

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre est réservé à l’usage interne chez Microsoft.

UsernameMatchesAnyOfPatterns

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre UsernameMatchesAnyOfPatterns spécifie une condition pour la règle d’accès client qui est basée sur le nom de compte de l’utilisateur. Ce paramètre accepte du texte et le caractère générique (*). Les caractères non alphanumériques n’exigent pas de caractère d’échappement.

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

UserRecipientFilter

Facultatif

System.String

Le paramètre UserRecipientFilter spécifie une condition pour la règle d’accès client qui utilise la syntaxe de filtre OPath pour identifier l’utilisateur. Par exemple, {City -eq "Redmond"}. Les attributs filtrables que vous pouvez utiliser avec ce paramètre sont les suivants :

  • City

  • Company

  • CountryOrRegion

  • CustomAttribute1-15

  • Department

  • Office

  • PostalCode

  • StateOrProvince

  • StreetAddress

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

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.

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.

 
Afficher: