Connect-SPOService
Connecte un administrateur SharePoint ou un administrateur SharePoint Embedded au centre d’administration SharePoint. Vous devez exécuter cette applet de commande avant d’exécuter les autres applets de commande SharePoint Online.
Syntaxe
AuthenticationCertificate
Connect-SPOService
[-Url] <UrlCmdletPipeBind>
[[-ClientTag] <String>]
-ClientId <String>
-TenantId <String>
[-Region <AADCrossTenantAuthenticationLocation>]
[-AuthenticationUrl <String>]
[-Certificate <X509Certificate2>]
[-CertificatePath <String>]
[-CertificateThumbprint <String>]
[-CertificatePassword <SecureString>]
[<CommonParameters>]
AuthenticationLocation
Connect-SPOService
[-Url] <UrlCmdletPipeBind>
[[-Credential] <CredentialCmdletPipeBind>]
[[-ClientTag] <String>]
[[-ModernAuth] <Boolean>]
[[-UseSystemBrowser] <Boolean>]
[-Region <AADCrossTenantAuthenticationLocation>]
[<CommonParameters>]
AuthenticationManagedIdentity
Connect-SPOService
-Url <UrlCmdletPipeBind>
[-ClientTag <String>]
[-ManagedIdentity]
[-ManagedIdentityType <ManagedIdentityType>]
[-ManagedIdentityClientId <String>]
[<CommonParameters>]
AuthenticationUrl
Connect-SPOService
[-Url] <UrlCmdletPipeBind>
[[-Credential] <CredentialCmdletPipeBind>]
[[-ClientTag] <String>]
[[-ModernAuth] <Boolean>]
[[-UseSystemBrowser] <Boolean>]
-AuthenticationUrl <String>
[<CommonParameters>]
Description
Cette applet de commande connecte un administrateur SharePoint ou un administrateur SharePoint Embedded au centre d’administration SharePoint. Une seule connexion au service SharePoint Online est prise en charge par session Windows PowerShell et par zone géographique au sein d’une organisation. Si vous exécutez à nouveau cette applet de commande, la connexion existante est automatiquement déconnectée et remplacée par la nouvelle. La session PowerShell utilise ensuite le contexte d’administrateur nouvellement spécifié. Les administrateurs partenaires délégués doivent changer de connexion lors de la gestion de plusieurs organisations au sein d’une même session PowerShell. Pour exécuter cette applet de commande, vous devez être administrateur SharePoint ou administrateur SharePoint Embedded. Pour connaître les exigences en matière d’autorisation et obtenir les dernières instructions, consultez la présentation de la documentation de SharePoint Online Management Shell.
Exemples
EXEMPLE 1
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
Cet exemple montre comment un administrateur SharePoint utilisant ce admin@contoso.com compte se connecte au centre d’administration SharePoint sur https://contoso-admin.sharepoint.com.
EXEMPLE 2
$username = "admin@contoso.sharepoint.com"
$password = Read-Host -Prompt "Enter user password" -AsSecureString
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $userName, $password
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred
Cet exemple montre comment un administrateur SharePoint se connecte au Centre d’administration SharePoint à https://contoso-admin.sharepoint.com en créant un objet d’informations d’identification à partir d’un nom d’utilisateur et d’un mot de passe.
EXEMPLE 3
Connect-SPOService -Url https://contoso-admin.sharepoint.com
Cet exemple invite à saisir des informations d’identification. Cette approche est obligatoire lorsque le compte utilise l’authentification multifacteur.
EXEMPLE 4
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR
Cet exemple se connecte au centre d’administration SharePoint en spécifiant la région d’authentification.
EXEMPLE 5
Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations
Cet exemple se connecte au centre d’administration SharePoint à l’aide de l’authentification moderne.
EXEMPLE 6
Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true
Cet exemple s’authentifie à l’aide de la bibliothèque d’authentification Microsoft (MSAL) et se connecte au centre d’administration SharePoint une fois l’authentification réussie.
EXEMPLE 7
$password = Read-Host -Prompt "Enter certificate password" -AsSecureString
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password
Cet exemple se connecte au Centre d’administration SharePoint à l’aide d’une identité d’application et d’un chemin d’accès de fichier de certificat, avec un mot de passe de certificat facultatif.
EXEMPLE 8
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"
Cet exemple se connecte au centre d’administration SharePoint à l’aide d’une identité d’application et d’une empreinte de certificat.
EXEMPLE 9
$thumbprint = "3F2A5C9D4E7B8A1234567890ABCDEF1234567890"
$cert = Get-ChildItem Cert:\LocalMachine\My\$thumbprint
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -Certificate $cert
Cet exemple se connecte au centre d’administration SharePoint à l’aide d’une identité d’application et d’un objet de certificat.
Exemple 10.
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ManagedIdentity
Cet exemple se connecte au centre d’administration SharePoint à l’aide de l’identité managée affectée par le système.
EXEMPLE 11
Connect-SPOService -url https://contoso-admin.sharepoint.com -ManagedIdentity -ManagedIdentityType UserAssigned -ManagedIdentityClientId 00000000-0000-0000-0000-000000000000
Cet exemple se connecte au centre d’administration SharePoint à l’aide de l’identité managée affectée par l’utilisateur.
Paramètres
-AuthenticationUrl
Applicable : SharePoint Online
Spécifie l’URL du service d’authentification inter-clients Microsoft Entra. Utilisez ce paramètre lorsqu’un point de terminaison d’authentification inter-clients autre que celui par défaut est requis.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuthenticationUrl
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Certificate
Applicable : SharePoint Online
Spécifie le certificat X.509 utilisé pour l’authentification.
Propriétés du paramètre
| Type: | X509Certificate2 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuthenticationCertificate
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CertificatePassword
Applicable : SharePoint Online
Spécifie le mot de passe du fichier de certificat.
Propriétés du paramètre
| Type: | SecureString |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuthenticationCertificate
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CertificatePath
Applicable : SharePoint Online
Spécifie le chemin d’accès au fichier de certificat local .pfx .
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
AuthenticationCertificate
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CertificateThumbprint
Applicable : SharePoint Online
Spécifie l’empreinte du certificat dans le magasin de certificats de l’utilisateur actuel.
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
AuthenticationCertificate
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ClientId
Applicable : SharePoint Online
Spécifie l’ID client de l’application.
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 |
| Alias: | ApplicationId |
Jeux de paramètres
AuthenticationCertificate
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ClientTag
Applicable : SharePoint Online
Ajoute éventuellement une balise client au trafic HTTP CSOM pour vous aider à identifier le script ou la solution appelante.
Propriétés du paramètre
| Type: | System.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 |
-Credential
Applicable : SharePoint Online
Indique les informations d’identification utilisées pour se connecter. Si vous ne fournissez pas d’informations d’identification, vous êtes invité à les saisir. Les informations d’identification doivent appartenir à un administrateur qui a accès au Centre d’administration SharePoint.
Propriétés du paramètre
| Type: | Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuthenticationUrl
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
AuthenticationLocation
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ManagedIdentity
Applicable : SharePoint Online
Indique que la connexion utilise une identité managée au lieu d’une authentification basée sur l’utilisateur ou par certificat.
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
AuthenticationManagedIdentity
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ManagedIdentityClientId
Applicable : SharePoint Online
Spécifie l’ID client d’une identité managée affectée par l’utilisateur à utiliser pour l’authentification.
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
AuthenticationManagedIdentity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ManagedIdentityType
Applicable : SharePoint Online
Spécifie le type d’identité managée à utiliser lors de l’authentification. S’il n’est pas spécifié, le type d’identité managée par défaut est utilisé.
Propriétés du paramètre
| Type: | ManagedIdentityType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuthenticationManagedIdentity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ModernAuth
Applicable : SharePoint Online
Active l’authentification moderne lors de la connexion aux applets de commande d’administration SharePoint.
Lorsque vous utilisez ce paramètre, vous devez également le AuthenticationUrl spécifier.
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuthenticationUrl
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
AuthenticationLocation
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Region
Applicable : SharePoint Online
Spécifie la région d’authentification. Les valeurs valides sont : Default, ITAR, Germanyet China.
La valeur par défaut est Default.
Remarque : La ITAR valeur s’applique uniquement aux locataires GCC High et DoD.
Propriétés du paramètre
| Type: | Microsoft.Online.SharePoint.PowerShell.AADCrossTenantAuthenticationLocation |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuthenticationLocation
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
AuthenticationCertificate
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TenantId
Applicable : SharePoint Online
Spécifie l’ID du client auquel se connecter.
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
AuthenticationCertificate
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Url
Applicable : SharePoint Online
Spécifie l’URL du centre d’administration SharePoint.
Propriétés du paramètre
| Type: | Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind |
| 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: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-UseSystemBrowser
Applicable : SharePoint Online
Utilise la bibliothèque d’authentification Microsoft (MSAL) pour authentifier l’utilisateur à l’aide du navigateur système.
Remarque
Pour éviter d’ajouter le -UseSystemBrowser paramètre à chaque fois que vous exécutez Connect-SPOService, vous pouvez définir une clé de Registre à la place.
Définissez la clé de UseSystemBrowser Registre (type REG_DWORD) sur : HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\
Si l’une des clés de Registre est définie sur une valeur entière non égale à zéro ou -UseSystemBrowser si le paramètre est défini sur true, le flux d’authentification utilise le navigateur système pour la connexion.
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuthenticationUrl
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
AuthenticationLocation
| 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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.