Connect-ExchangeOnline
Cette applet de commande est disponible uniquement dans le module PowerShell Exchange Online. Pour plus d’informations, consultez À propos du module PowerShell Exchange Online.
Utilisez l’applet de commande Connect-ExchangeOnline dans le module PowerShell Exchange Online pour utiliser l’authentification moderne afin de vous connecter à Exchange Online PowerShell ou PowerShell pour le module complémentaire de sécurité intégré pour les boîtes aux lettres locales. Cette applet de commande fonctionne pour les comptes avec ou sans authentification multifacteur (MFA).
Pour vous connecter à Security & Compliance PowerShell, utilisez l’applet de commande Connect-IPPSSession .
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)
Connect-ExchangeOnline
[[-ConnectionUri] <String>]
[[-AzureADAuthorizationEndpointUri] <String>]
[[-ExchangeEnvironmentName] <ExchangeEnvironment>]
[[-PSSessionOption] <PSSessionOption>]
[[-DelegatedOrganization] <String>]
[[-Prefix] <String>]
[[-CommandName] <String[]>]
[[-FormatTypeName] <String[]>]
[-AccessToken <String>]
[-AppId <String>]
[-BypassMailboxAnchoring]
[-Certificate <X509Certificate2>]
[-CertificateFilePath <String>]
[-CertificatePassword <SecureString>]
[-CertificateThumbprint <String>]
[-Credential <PSCredential>]
[-Device]
[-DisableWAM]
[-EnableErrorReporting]
[-EXOModuleBasePath <String>]
[-InlineCredential]
[-LoadCmdletHelp]
[-LogDirectoryPath <String>]
[-LogLevel <LogLevel>]
[-ManagedIdentity]
[-ManagedIdentityAccountId <String>]
[-Organization <String>]
[-PageSize <UInt32>]
[-ShowBanner]
[-ShowProgress <Boolean>]
[-SigningCertificate <X509Certificate2>]
[-SkipLoadingCmdletHelp]
[-SkipLoadingFormatData]
[-TrackPerformance <Boolean>]
[-UseMultithreading <Boolean>]
[-UserPrincipalName <String>]
[-UseRPSSession]
[<CommonParameters>]
Description
Cette applet de commande crée une connexion PowerShell à votre Exchange Online organization.
Les commandes de connexion échoueront probablement si le chemin du profil du compte que vous avez utilisé pour vous connecter contient des caractères PowerShell spéciaux (par exemple, $). La solution de contournement consiste à se connecter à l’aide d’un autre compte qui n’a pas de caractères spéciaux dans le chemin d’accès du profil.
Exemples
Exemple 1
Connect-ExchangeOnline -UserPrincipalName chris@contoso.com
Cet exemple se connecte à Exchange Online PowerShell à l’aide de l’authentification moderne, avec ou sans authentification multifacteur (MFA). La connexion utilise le mode API REST et ne nécessite pas l’activation de l’authentification de base dans WinRM sur l’ordinateur local.
Exemple 2
Connect-ExchangeOnline -AppId <%App_id%> -CertificateThumbprint <%Thumbprint string of certificate%> -Organization "contoso.onmicrosoft.com"
Cet exemple se connecte à Exchange Online PowerShell dans un scénario de script sans assistance à l’aide d’une empreinte numérique de certificat.
Exemple 3
Connect-ExchangeOnline -AppId <%App_id%> -Certificate <%X509Certificate2 object%> -Organization "contoso.onmicrosoft.com"
Cet exemple se connecte à Exchange Online PowerShell dans un scénario de script sans assistance à l’aide d’un fichier de certificat. Cette méthode est idéale pour les scénarios où le certificat est stocké sur des machines distantes et extrait au moment de l’exécution. Par exemple, le certificat est stocké dans le Azure Key Vault.
Exemple 4
Connect-ExchangeOnline -Device
Dans PowerShell 7.0.3 ou version ultérieure à l’aide de la version 2.0.4 ou ultérieure du module, cet exemple se connecte à Exchange Online PowerShell dans des scénarios de script interactif sur des ordinateurs qui n’ont pas de navigateur web.
La commande renvoie une URL et un code unique liés à la session. Vous devez ouvrir l’URL dans un navigateur sur n’importe quel ordinateur, puis entrer le code unique. Une fois que vous avez terminé la connexion dans le navigateur web, la session dans la fenêtre PowerShell 7 est authentifiée via le flux d’authentification Microsoft Entra standard, et les applets de commande Exchange Online sont importées après quelques secondes.
Exemple 6
Connect-ExchangeOnline -InlineCredential
Dans PowerShell 7.0.3 ou version ultérieure à l’aide de la version 2.0.4 ou ultérieure du module, cet exemple se connecte à Exchange Online PowerShell dans des scénarios de script interactif en transmettant des informations d’identification directement dans la fenêtre PowerShell.
Paramètres
-AccessToken
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 3.1.0-Preview1 ou ultérieure.
Le paramètre AccessToken spécifie le jeton web JSON OAuth (JWT) utilisé pour se connecter à Exchange Online.
Selon le type de jeton d’accès, vous devez utiliser ce paramètre avec les paramètres Organization, DelegatedOrganization ou UserPrincipalName.
Propriétés des paramètres
| 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 |
-AppId
Applicable : Exchange Online
Le paramètre AppId spécifie l’ID d’application du principal de service utilisé dans l’authentification basée sur les certificats (CBA). Une valeur valide est le GUID de l’ID d’application (principal de service). Par exemple : 36ee4c6c-0812-40a2-b820-b22ebd02bce3.
Pour plus d’informations, consultez Authentification d’application uniquement pour les scripts sans assistance dans le module PowerShell Exchange Online.
Propriétés des paramètres
| 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 |
-AzureADAuthorizationEndpointUri
Applicable : Exchange Online
Remarque : Si vous utilisez le paramètre ExchangeEnvironmentName, vous n’avez pas besoin d’utiliser les paramètres AzureADAuthorizationEndpointUri ou ConnectionUri.
Le paramètre AzureADAuthorizationEndpointUri spécifie le point de terminaison d’autorisation Microsoft Entra qui peut émettre des jetons d’accès OAuth2. Les Exchange Online environnements PowerShell suivants et les valeurs associées sont pris en charge :
- Microsoft 365 ou Microsoft 365 GCC : n’utilisez pas ce paramètre. La valeur requise est
https://login.microsoftonline.com/organizations, mais il s’agit également de la valeur par défaut. Vous n’avez donc pas besoin d’utiliser ce paramètre. - Office 365 Allemagne :
https://login.microsoftonline.de/organizations - Microsoft 365 GCC High ou Microsoft 365 DoD :
https://login.microsoftonline.us/organizations
La valeur d’URI se terminant par /organizations autorise uniquement les comptes professionnels ou scolaires. L’ancienne valeur d’URI se terminant par /common fonctionne toujours, mais peut vous inviter à choisir entre un compte personnel et un compte professionnel ou scolaire. Nous recommandons la valeur de l’URI /organizations dans les scénarios d’entreprise où les comptes de consommateur doivent être exclus.
Si vous utilisez le paramètre UserPrincipalName, vous n’avez pas besoin d’utiliser le paramètre AzureADAuthorizationEndpointUri pour l’authentification multifacteur ou les utilisateurs fédérés dans des environnements qui en ont normalement besoin (UserPrincipalName ou AzureADAuthorizationEndpointUri est requis ; OK pour utiliser les deux).
Remarque : l’authentification MFA ou l’authentification fédérée n’est pas disponible dans Office 365 géré par 21Vianet.
Propriétés des paramètres
| 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: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-BypassMailboxAnchoring
Applicable : Exchange Online
Le commutateur BypassMailboxAnchoring contourne l’utilisation de l’indicateur d’ancrage de boîte aux lettres. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| 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 |
-Certificate
Applicable : Exchange Online
Le paramètre Certificate spécifie le certificat utilisé pour l’authentification basée sur les certificats (CBA). Une valeur valide est la valeur de l’objet X509Certificate2 du certificat.
N’utilisez pas ce paramètre avec les paramètres CertificateFilePath ou CertificateThumbprint.
Pour plus d’informations sur l’authentification par certificat, consultez Authentification d’application uniquement pour les scripts sans assistance dans le module PowerShell Exchange Online.
Propriétés des paramètres
| Type: | X509Certificate2 |
| 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 |
-CertificateFilePath
Applicable : Exchange Online
Le paramètre CertificateFilePath spécifie le certificat utilisé pour l’authentification CBA. Une valeur valide est le chemin d’accès public complet au fichier de certificat. Utilisez le paramètre CertificatePassword avec ce paramètre.
N’utilisez pas ce paramètre avec les paramètres Certificate ou CertificateThumbprint.
Pour plus d’informations sur l’authentification par certificat, consultez Authentification d’application uniquement pour les scripts sans assistance dans le module PowerShell Exchange Online.
Propriétés des paramètres
| 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 |
-CertificatePassword
Applicable : Exchange Online
Le paramètre CertificatePassword spécifie le mot de passe requis pour ouvrir le fichier de certificat lorsque vous utilisez le paramètre CertificateFilePath pour identifier le certificat utilisé pour l’authentification basée sur les certificats.
Vous pouvez utiliser les méthodes suivantes comme valeur pour ce paramètre :
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force). - Avant d’exécuter cette commande, stockez le mot de passe en tant que variable (par exemple,
$password = Read-Host "Enter password" -AsSecureString), puis utilisez la variable ($password) pour la valeur. -
(Get-Credential).passwordpour être invité à entrer le mot de passe en toute sécurité lorsque vous exécutez cette commande.
Pour plus d’informations sur l’authentification par certificat, consultez Authentification d’application uniquement pour les scripts sans assistance dans le module PowerShell Exchange Online.
Remarque : L’utilisation d’une commande ConvertTo-SecureString pour stocker le mot de passe du certificat localement contrecarré l’objectif d’une méthode de connexion sécurisée pour les scénarios d’automatisation. L’utilisation d’une commande Get-Credential pour vous demander le mot de passe du certificat en toute sécurité n’est pas idéale pour les scénarios d’automatisation. En d’autres termes, il n’existe aucun moyen automatisé et sécurisé de se connecter à l’aide d’un certificat local.
Propriétés des paramètres
| Type: | SecureString |
| 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 |
-CertificateThumbprint
Applicable : Exchange Online
Le paramètre CertificateThumbprint spécifie le certificat utilisé pour l’authentification CBA. Une valeur valide est la valeur d’empreinte numérique du certificat. Par exemple : 83213AEAC56D61C97AEE5C1528F4AC5EBA7321C1.
N’utilisez pas ce paramètre avec les paramètres Certificate ou CertificateFilePath.
Remarque : Le paramètre CertificateThumbprint est pris en charge uniquement dans Microsoft Windows.
Pour plus d’informations sur l’authentification par certificat, consultez Authentification d’application uniquement pour les scripts sans assistance dans le module PowerShell Exchange Online.
Propriétés des paramètres
| 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 |
-CommandName
Applicable : Exchange Online
Le paramètre CommandName spécifie la liste séparée par des virgules des commandes à importer dans la session. Utilisez ce paramètre pour les applications ou les scripts qui utilisent un ensemble spécifique d’applets de commande. La réduction du nombre d’applets de commande dans la session permet d’améliorer les performances et de réduire l’empreinte mémoire de l’application ou du script.
Propriétés des paramètres
| 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: | 6 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ConnectionUri
Applicable : Exchange Online
Remarque : Si vous utilisez le paramètre ExchangeEnvironmentName, vous n’avez pas besoin d’utiliser les paramètres AzureADAuthorizationEndpointUri ou ConnectionUri.
Le paramètre ConnectionUri spécifie le point de terminaison de connexion pour la session PowerShell. Les Exchange Online environnements PowerShell suivants et les valeurs associées sont pris en charge :
- Microsoft 365 ou Microsoft 365 GCC : n’utilisez pas ce paramètre. La valeur requise est
https://outlook.office365.com/powershell-liveid/, mais il s’agit également de la valeur par défaut. Vous n’avez donc pas besoin d’utiliser ce paramètre. - Office 365 Allemagne :
https://outlook.office.de/PowerShell-LiveID - Office 365 géré par 21Vianet :
https://partner.outlook.cn/PowerShell - Microsoft 365 GCC High :
https://outlook.office365.us/powershell-liveID - Microsoft 365 DoD :
https://webmail.apps.mil/powershell-liveID
Propriétés des paramètres
| 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: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Applicable : Exchange Online
Le paramètre Credential spécifie le nom d’utilisateur et le mot de passe utilisés pour se connecter à Exchange Online PowerShell. En règle générale, vous utilisez ce paramètre dans des scripts ou lorsque vous avez besoin de fournir différentes informations d’identification qui ont les autorisations requises. N’utilisez pas ce paramètre pour les comptes qui utilisent l’authentification multifacteur (MFA).
Avant d’exécuter la commande Connect-ExchangeOnline, stockez le nom d’utilisateur et le mot de passe dans une variable (par exemple, $UserCredential = Get-Credential). Ensuite, utilisez le nom de la variable ($UserCredential) pour ce paramètre.
Une fois la commande Connect-ExchangeOnline terminée, la clé de mot de passe dans la variable est vidée.
Pour spécifier le mot de passe d’un fichier de certificat, n’utilisez pas ce paramètre ; utilisez le paramètre CertificatePassword à la place.
Propriétés des paramètres
| Type: | PSCredential |
| 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 |
-DelegatedOrganization
Applicable : Exchange Online
Le paramètre DelegatedOrganization spécifie le client organization que vous souhaitez gérer. Une valeur valide pour ce paramètre est l’ID de domaine .onmicrosoft.com principal ou de locataire du organization client.
Ce paramètre fonctionne uniquement si le client organization a accepté votre gestion déléguée via le programme CSP.
Une fois l’authentification réussie, les applets de commande de cette session sont mappées au organization client, et toutes les opérations de cette session sont effectuées sur le client organization.
Propriétés des paramètres
| 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: | 4 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Device
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 2.0.4-Preview6 ou ultérieure, et uniquement dans PowerShell 7.
Le commutateur d’appareil est généralement utilisé sur les ordinateurs sans navigateur web. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
L’utilisation de ce commutateur génère un message à l’écran qui contient l’URL https://microsoft.com/devicelogin et un code unique. Sur tout autre appareil disposant d’un navigateur web et d’un accès à Internet, ouvrez l’URL, entrez le code unique et entrez vos informations d’identification dans les pages suivantes.
Si votre connexion a réussi, la connexion PowerShell continue.
Propriétés des paramètres
| 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 |
-DisableWAM
Applicable : Exchange Online
Remarque : ce paramètre est disponible dans le module version 3.7.2-Preview1 ou ultérieure.
Le commutateur DisableWAM désactive le Gestionnaire de comptes web (WAM). Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
À compter de la version 3.7.0, WAM est activé par défaut lors de la connexion à Exchange Online. Si vous rencontrez des problèmes liés à WAM lors de la connexion, vous pouvez utiliser ce commutateur pour désactiver WAM.
Propriétés des paramètres
| 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 |
-EnableErrorReporting
Applicable : Exchange Online
Le commutateur EnableErrorReporting spécifie s’il faut activer le rapport d’erreurs. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés des paramètres
| 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 |
-ExchangeEnvironmentName
Applicable : Exchange Online
ExchangeEnvironmentName spécifie l’environnement Exchange Online et élimine la nécessité d’utiliser les paramètres AzureADAuthorizationEndpointUri et ConnectionUri. Les environnements PowerShell Exchange Online suivants sont pris en charge :
- Microsoft 365 ou Microsoft 365 GCC : n’utilisez pas ce paramètre. La valeur requise est
O365Default, mais il s’agit également de la valeur par défaut. Vous n’avez donc pas besoin d’utiliser ce paramètre. - Office 365 Allemagne :
O365GermanyCloud - Office 365 géré par 21Vianet :
O365China - Microsoft 365 GCC High :
O365USGovGCCHigh - Microsoft 365 DoD :
O365USGovDoD
Propriétés des paramètres
| Type: | ExchangeEnvironment |
| Valeur par défaut: | O365Default |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-EXOModuleBasePath
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 3.9.1-Preview1 ou ultérieure.
Le paramètre EXOModuleBasePath spécifie le dossier dans lequel la copie temporaire locale du module PowerShell Exchange Online est stockée. Si la valeur contient des espaces, placez-la entre guillemets (").
Connect-ExchangeOnline commandes stockent une copie temporaire du module Exchange Online localement sur le client pour la connectivité de session. Par défaut, la copie temporaire du module est stockée dans le dossier %TMP % (par défaut, C:\Users\<UserName>\AppData\Local\Temp).
Propriétés des paramètres
| 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 |
-FormatTypeName
Applicable : Exchange Online
Le paramètre FormatTypeName spécifie le format de sortie de l’applet de commande.
Propriétés des paramètres
| 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: | 7 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InlineCredential
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 2.0.4-Preview6 ou ultérieure, et uniquement dans PowerShell 7.
Le commutateur InlineCredential spécifie s’il faut transmettre les informations d’identification directement dans la fenêtre Windows PowerShell. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Ce commutateur est similaire au paramètre Credential, mais avec une sécurité accrue. Le commutateur InlineCredential ne vous oblige pas à stocker les informations d’identification localement dans le script, et vous pouvez entrer des informations d’identification directement dans une session PowerShell interactive.
Ce commutateur ne fonctionne pas avec les comptes qui utilisent l’authentification multifacteur.
Propriétés des paramètres
| 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 |
-LoadCmdletHelp
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 3.7.0-Preview1 ou ultérieure.
Le commutateur LoadCmdletHelp télécharge les fichiers d’aide de l’applet de commande Get-Help dans les connexions d’API REST. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
À compter de v3.7.0-Preview1, les fichiers d’aide de la ligne de commande ne sont pas téléchargés par défaut. Utilisez ce commutateur pour télécharger les fichiers pour obtenir de l’aide sur l’applet de commande sur la ligne de commande.
Conseil : ce paramètre remplace le paramètre SkipLoadingCmdletHelp. Le paramètre SkipLoadingCmdletHelp n’est plus nécessaire et ne fonctionne plus, car les fichiers d’aide des applets de commande ne sont plus téléchargés par défaut.
Propriétés des paramètres
| 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 |
-LogDirectoryPath
Applicable : Exchange Online
Le paramètre LogDirectoryPath spécifie l’emplacement des fichiers journaux. L’emplacement par défaut est %TMP%\EXOCmdletTelemetry\EXOCmdletTelemetry-yyyymmdd-hhmmss.csv.
Si vous spécifiez un emplacement personnalisé et un nom de fichier contenant des espaces, placez la valeur entre guillemets (").
Propriétés des paramètres
| 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 |
-LogLevel
Applicable : Exchange Online
Le paramètre LogLevel spécifie le niveau de journalisation. Les valeurs valides sont Default et All.
Propriétés des paramètres
| 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 |
-ManagedIdentity
Applicable : Exchange Online
Le commutateur ManagedIdentity spécifie que vous utilisez l’identité managée pour vous connecter. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Les connexions d’identité managée sont actuellement prises en charge pour les types de ressources Azure suivants :
- runbooks Azure Automation
- Ordinateurs virtuels Azure
- Azure Virtual Machine Scale Sets
- Azure Functions
Vous devez utiliser ce commutateur avec le paramètre Organization.
Pour l’identité managée affectée par l’utilisateur, vous devez également utiliser ce commutateur avec le paramètre ManagedIdentityAccountId.
Pour plus d’informations sur la connexion avec une identité managée, consultez Utiliser Azure identités managées pour se connecter à Exchange Online PowerShell.
Propriétés des paramètres
| 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 |
-ManagedIdentityAccountId
Applicable : Exchange Online
Le paramètre ManagedIdentityAccountId spécifie l’identité managée affectée par l’utilisateur que vous utilisez pour vous connecter. Une valeur valide pour ce paramètre est l’ID d’application (GUID) du principal de service qui correspond à l’identité managée affectée par l’utilisateur dans Azure.
Vous devez utiliser ce paramètre avec le paramètre Organization et le commutateur ManagedIdentity.
Pour plus d’informations sur la connexion avec une identité managée, consultez Utiliser Azure identités managées pour se connecter à Exchange Online PowerShell.
Propriétés des paramètres
| 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 |
-Organization
Applicable : Exchange Online
Le paramètre Organization spécifie le organization lorsque vous vous connectez à l’aide de l’authentification CBA ou de l’identité managée. Une valeur valide pour ce paramètre est l’ID de locataire ou de domaine .onmicrosoft.com principal du organization.
Pour plus d’informations sur la connexion avec l’authentification CBA, consultez Authentification d’application uniquement pour les scripts sans assistance dans le module PowerShell Exchange Online.
Pour plus d’informations sur la connexion avec une identité managée, consultez Utiliser Azure identités managées pour se connecter à Exchange Online PowerShell.
Propriétés des paramètres
| 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 |
-PageSize
Applicable : Exchange Online
Le paramètre PageSize indique le nombre maximal d’entrées par page. L’entrée valide pour ce paramètre est un entier entre 1 et 1 000. La valeur par défaut est 1000.
Propriétés des paramètres
| Type: | UInt32 |
| 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 |
-Prefix
Applicable : Exchange Online
Le paramètre Prefix spécifie une valeur de texte à ajouter aux noms des applets de commande PowerShell Exchange Online lorsque vous vous connectez. Par exemple, Get-InboundConnector devient Get-ContosoInboundConnector lorsque vous utilisez la valeur Contoso pour ce paramètre.
- La valeur Prefix ne peut pas contenir d’espaces ou de caractères spéciaux tels que des traits de soulignement ou des astérisque.
- Vous ne pouvez pas utiliser la valeur de préfixe EXO. Cette valeur est réservée aux neuf applets de commande Get-EXO* exclusives intégrées au module.
- Le paramètre Prefix affecte uniquement les noms d’applet de commande Exchange Online importés. Cela n’affecte pas les noms des applets de commande intégrées au module (par exemple, Disconnect-ExchangeOnline).
Propriétés des paramètres
| 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: | 5 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PSSessionOption
Applicable : Exchange Online
Remarque : Ce paramètre ne fonctionne pas dans les connexions d’API REST.
Le paramètre PSSessionOption spécifie les options de session PowerShell à utiliser dans votre connexion à Exchange Online. Ce paramètre fonctionne uniquement si vous utilisez également le commutateur UseRPSSession dans la même commande.
Stockez la sortie de la commande New-PSSessionOption dans une variable (par exemple, $PSOptions = New-PSSessionOption <Settings>) et utilisez le nom de la variable comme valeur pour ce paramètre (par exemple, $PSOptions).
Propriétés des paramètres
| Type: | PSSessionOption |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 3 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ShowBanner
Applicable : Exchange Online
Le commutateur ShowBanner affiche ou masque le message de bannière qui s’affiche lorsque vous exécutez Connect-ExchangeOnline. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
- Pour afficher la bannière, vous n’avez pas besoin d’utiliser ce commutateur (la bannière est affichée par défaut).
- Pour masquer la bannière, utilisez la syntaxe exacte suivante :
-ShowBanner:$false.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | $true |
| 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 |
-ShowProgress
Applicable : Exchange Online
Le paramètre ShowProgress spécifie s’il faut afficher ou masquer la barre de progression des applets de commande importées lorsque vous vous connectez. Les valeurs valides sont les suivantes :
- $true : la barre de progression s’affiche. Cette valeur est la valeur par défaut.
- $false : actuellement, cette valeur n’a aucun effet.
Propriétés des paramètres
| 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 |
-SigningCertificate
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 3.2.0-Preview4 ou ultérieure.
Le paramètre SigningCertificate spécifie le certificat client utilisé pour signer les fichiers de format (*). Format.ps1xml) ou fichiers de module de script (.psm1) dans le module temporaire que Connect-ExchangeOnline crée.
Une valeur valide pour ce paramètre est une variable qui contient le certificat, ou une commande ou une expression qui obtient le certificat.
Pour rechercher le certificat, utilisez l’applet de commande Get-PfxCertificate dans le module Microsoft.PowerShell.Security ou utilisez l’applet de commande Get-ChildItem dans le lecteur de certificat (Cert :). Si le certificat n’est pas valide ou ne dispose pas d’une autorité suffisante, la commande échoue.
Propriétés des paramètres
| Type: | X509Certificate2 |
| 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 |
-SkipLoadingCmdletHelp
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 3.3.0-Preview1 ou ultérieure.
Dans la version 3.7.0-Preview1 ou ultérieure, ce paramètre est remplacé par le paramètre LoadCmdletHelp. Le paramètre SkipLoadingCmdletHelp n’est plus nécessaire et ne fait plus rien, car les fichiers d’aide des applets de commande ne sont plus téléchargés par défaut.
Le commutateur SkipLoadingCmdletHelp empêche le téléchargement des fichiers d’aide d’applet de commande pour l’applet de commande Get-Help dans les connexions d’API REST. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Lorsque vous utilisez ce commutateur, vous n’obtenez aucun fichier d’aide local pour une applet de commande sur la ligne de commande.
Ce commutateur ne fonctionne pas avec le commutateur UseRPSSession.
Propriétés des paramètres
| 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 |
-SkipLoadingFormatData
Applicable : Exchange Online
Le commutateur SkipLoadingFormatData empêche le téléchargement des données de format pour les connexions d’API REST. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Lorsque vous utilisez ce commutateur, la sortie d’une applet de commande Exchange n’est pas mise en forme.
Utilisez ce commutateur pour éviter les erreurs lors de la connexion à Exchange Online PowerShell à partir d’un service Windows ou du SDK Windows PowerShell.
Ce commutateur ne fonctionne pas avec le commutateur UseRPSSession.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| 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 |
-TrackPerformance
Applicable : Exchange Online
Le paramètre TrackPerformance mesure des événements supplémentaires (par exemple, la charge du processeur et la mémoire consommée). Les valeurs valides sont les suivantes :
- $true : le suivi des performances est activé.
- $false : le suivi des performances est désactivé. Cette valeur est la valeur par défaut.
Ce paramètre fonctionne uniquement lorsque la journalisation est activée.
Propriétés des paramètres
| 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 |
-UseMultithreading
Applicable : Exchange Online
Le paramètre UseMultithreading spécifie s’il faut désactiver ou activer le multithreading dans le module PowerShell Exchange Online. Les valeurs valides sont les suivantes :
- $true : activer le multithreading. Cette valeur est la valeur par défaut.
- $false : désactivez le multithreading. Cette valeur dégrade les performances des neuf applets de commande Get-EXO* exclusives dans le module.
Propriétés des paramètres
| 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 |
-UserPrincipalName
Applicable : Exchange Online
Le paramètre UserPrincipalName spécifie le compte que vous souhaitez utiliser pour vous connecter (par exemple, navin@contoso.onmicrosoft.com). L’utilisation de ce paramètre vous permet d’ignorer la saisie d’un nom d’utilisateur dans l’invite d’informations d’identification d’authentification moderne (vous êtes invité à entrer un mot de passe).
Si vous utilisez le paramètre UserPrincipalName, vous n’avez pas besoin d’utiliser le paramètre AzureADAuthorizationEndpointUri pour l’authentification multifacteur ou les utilisateurs fédérés dans des environnements qui en ont normalement besoin (UserPrincipalName ou AzureADAuthorizationEndpointUri est requis ; OK pour utiliser les deux).
Propriétés des paramètres
| 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 |
-UseRPSSession
Applicable : Exchange Online
Remarque : Les connexions PowerShell distantes à Exchange Online PowerShell sont déconseillées. Pour plus d’informations, consultez Dépréciation de PowerShell à distance dans Exchange Online.
Le commutateur UseRPSSession vous permet de vous connecter à Exchange Online PowerShell à l’aide d’un accès PowerShell distant traditionnel à toutes les applets de commande. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Si vous n’utilisez pas ce commutateur, le mode API REST étant utilisé pour la connexion, l’authentification de base dans WinRM n’est pas requise.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| 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 |
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.