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

Test-ClientAccessRule

 

S’applique à :Exchange Online

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

Utilisez la cmdlet Test-ClientAccessRule pour tester l’impact des règles d’accès client sur l’accès à votre organisation en nuage. Si l’une des propriétés clientes spécifiées pour cette cmdlet correspond à l’une des règles d’accès client, les règles sont renvoyées dans les résultats.

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

Test-ClientAccessRule -AuthenticationType <BasicAuthentication | NonBasicAuthentication | AdfsAuthentication | CertificateBasedAuthentication | OAuthAuthentication> -Protocol <ExchangeWebServices | RemotePowerShell | OutlookAnywhere | POP3 | IMAP4 | OutlookWebApp | ExchangeAdminCenter | ExchangeActiveSync | OfflineAddressBook | PowerShellWebServices | REST> -RemoteAddress <IPAddress> -RemotePort <Int32> -User <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-OAuthClaims <Hashtable>] [-WhatIf [<SwitchParameter>]]

Cet exemple teste l’accès client à l’aide des propriétés clientes suivantes :

  • Type d’authentification type   Authentification de base

  • Protocole   OutlookWebApp

  • Adresse distante   172.17.17.26

  • Port distant   443

  • Utilisateur   julia@contoso.com

Test-ClientAccessRule -AuthenticationType BasicAuthentication -Protocol OutlookWebApp -RemoteAddress 172.17.17.26 -RemotePort 443 -User julia@contoso.com

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

AuthenticationType

Obligatoire

Microsoft.Exchange.Data.ClientAccessAuthenticationMethod

Le paramètre AuthenticationType spécifie le type d’authentification client à tester.

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

  • AdfsAuthentication

  • BasicAuthentication

  • CertificateBasedAuthentication

  • NonBasicAuthentication

  • OAuthAuthentication

Dans les règles d’accès client, les types d’authentification sont définis par les paramètres AnyOfAuthenticationTypes et ExceptAnyOfAuthenticationTypes.

Protocol

Obligatoire

Microsoft.Exchange.Data.ClientAccessProtocol

Le paramètre Protocol spécifie le protocole client à tester.

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

  • ExchangeActiveSync

  • ExchangeAdminCenter

  • ExchangeWebServices

  • IMAP4

  • OfflineAddressBook

  • OutlookAnywhere

  • OutlookWebApp

  • POP3

  • PowerShellWebServices

  • RemotePowerShell

  • REST

Dans les règles d’accès client, les types de protocole sont définis par les paramètres AnyOfProtocols et ExceptAnyOfProtocols.

RemoteAddress

Obligatoire

System.Net.IPAddress

Le paramètre RemoteAddress spécifie l’adresse IP client à tester. L’entrée valide pour ce paramètre est une adresse IP. Par exemple, 192.168.1.50.

Dans les règles d’accès client, les adresses IP sont définies par les paramètres AnyOfClientIPAddressesOrRanges et ExceptAnyOfClientIPAddressesOrRanges.

RemotePort

Obligatoire

System.Int32

Le paramètre RemotePort spécifie le port TCP client à tester. L’entrée valide pour ce paramètre est un entier compris entre 1 et 65535.

Dans les règles d’accès client, les ports TCP sont définis par les paramètres AnyOfSourceTcpPortNumbers et ExceptAnyOfSourceTcpPortNumbers.

User

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre User spécifie le compte d’utilisateur à tester. Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur de façon unique.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Dans les règles d’accès client, les utilisateurs sont définis par les paramètres UserIsMemberOf, UsernameMatchesAnyOfPatterns, UserRecipientFilter, ExceptUserIsMemberOf et ExceptUsernameMatchesAnyOfPatterns.

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.

OAuthClaims

Facultatif

System.Collections.Hashtable

La OAuthClaims paramètre spécifie les jetons de revendication OAuth d’une application de couche intermédiaire.

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: