Partager via

Connect-SPOService

Module:
Microsoft.Online.SharePoint.PowerShell Module

Connecte l’administrateur SharePoint Online ou l’administrateur SharePoint Embedded à une connexion SharePoint Online (centre d’administration SharePoint Online). Cette applet de commande doit être exécutée avant que d’autres applets de commande SharePoint Online puissent s’exécuter.

Syntaxe

AuthenticationCertificate 

Connect-SPOService
    -Url <UrlCmdletPipeBind>
    -ClientId <String>
    -TenantId <String>
    [-ClientTag <String>]
    [-Region <AADCrossTenantAuthenticationLocation>]
    [-AuthenticationUrl <String>]
    [-Certificate <X509Certificate2>]
    [-CertificatePath <String>]
    [-CertificateThumbprint <String>]
    [-CertificatePassword <SecureString>]
    [<CommonParameters>]

AuthenticationLocation 

Connect-SPOService
    -Url <UrlCmdletPipeBind>
    [-Credential <CredentialCmdletPipeBind>]
    [-ClientTag <String>]
    [-Region <AADCrossTenantAuthenticationLocation>]
    [-ModernAuth <Boolean>]
    [-UseSystemBrowser <Boolean>]
    [<CommonParameters>]

AuthenticationUrl 

Connect-SPOService
    -Url <UrlCmdletPipeBind>
    -AuthenticationUrl <String>
    [-Credential <CredentialCmdletPipeBind>]
    [-ClientTag <String>]
    [-ModernAuth <Boolean>]
    [-UseSystemBrowser <Boolean>]
    [<CommonParameters>]

Description

L’applet Connect-SPOService de commande connecte l’administrateur SharePoint Online ou l’administrateur SharePoint Embedded au Centre d’administration SharePoint Online.

Une seule connexion de service SharePoint Online est conservée à partir d’une session Windows PowerShell unique. En d’autres termes, il s’agit d’une zone géographique au sein d’une connexion administrateur organization. L’exécution de l’applet Connect-SPOService de commande deux fois déconnecte implicitement la connexion précédente. La session Windows PowerShell sera définie pour servir le nouvel administrateur SharePoint Online spécifié.

Un administrateur partenaire délégué doit échanger des connexions pour différentes organisations au sein de la même session Windows PowerShell.

Vous devez être administrateur SharePoint Online ou administrateur SharePoint Embedded pour exécuter l’applet de commande.

Pour les autorisations et informations les plus récentes sur Windows PowerShell pour SharePoint Online, consultez la documentation en ligne sur Présentation de SharePoint Online Management Shell.

Exemples

EXEMPLE 1

Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential admin@contoso.com

L’exemple 1 montre comment un administrateur SharePoint Online avec des informations d’identification admin@contoso.com se connecte à un Centre d’administration SharePoint Online qui a l’URL <https://contoso-admin.sharepoint.com.>

EXEMPLE 2

$username = "admin@contoso.sharepoint.com"
$password = "password"
$cred = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $userName, $(convertto-securestring $Password -asplaintext -force)
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred

L’exemple 2 montre comment un administrateur SharePoint Online avec un nom d’utilisateur et un mot de passe se connecte à un Centre d’administration SharePoint Online qui a l’URL <https://contoso-admin.sharepoint.com.>

EXEMPLE 3

Connect-SPOService -Url https://contoso-admin.sharepoint.com

Requêtes pour les informations d’identification. Cela est obligatoire si le compte utilise l’authentification multifacteur.

EXEMPLE 4

Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR

Se connecte à un Centre d’administration SharePoint Online spécifiant la région.

EXEMPLE 5

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

Connexion au service SPO avec l’indicateur ModernAuth.

EXEMPLE 6

Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true

S’authentifie à l’aide de la bibliothèque d’authentification Microsoft (MSAL) et se connecte au Centre d’administration SharePoint Online en cas d’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 -Tenant 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password

Connectez-vous au service SharePoint Online à l’aide d’une identité d’application et d’un chemin d’accès au fichier de certificat, avec un mot de passe facultatif.

EXEMPLE 8

Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"

Connectez-vous au service SharePoint Online à l’aide d’une identité d’application et d’une empreinte numérique 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 -Tenant 11111111-1111-1111-1111-111111111111 -Certificate $cert

Connectez-vous au service SharePoint Online à l’aide d’une identité d’application et d’un objet de certificat.

Paramètres

-AuthenticationUrl

Applicable : SharePoint Online

Emplacement de Microsoft Entra service d’authentification interlocataire. Peut être utilisé éventuellement si un service d’authentification interlocataire autre que la valeur par défaut est utilisé.

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

Certificat X.509 utilisé lors de 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

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

Chemin d’accès au fichier de certificat .pfx local.

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

Empreinte numérique 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

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

Autorise l’ajout d’une balise cliente à une balise cliente existante. Utilisé éventuellement dans le trafic HTTP CSOM pour identifier le script ou la solution utilisé.

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

Spécifie les informations d'identification à utiliser pour se connecter. Si les informations d'identification ne sont pas spécifiées, une boîte de dialogue les demandera. Les informations d’identification doivent être celles d’un administrateur SharePoint Online qui peut accéder au site du Centre d’administration SharePoint Online.

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

-ModernAuth

Applicable : SharePoint Online

Garantit que les applets de commande d’administration de locataire SharePoint Online peuvent se connecter au service à l’aide de protocoles TLS modernes.

Pour l’utiliser, vous devez également fournir le paramètre AuthenticationUrl .

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

Les valeurs valides sont les suivantes : Par défaut | ITAR | Allemagne | Chine

La valeur par défaut est « default ».

Remarque : La valeur ITAR est uniquement pour les locations 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

ID de locataire 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 site du Centre d’administration SharePoint Online.

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

Utilisé pour authentifier l’utilisateur à l’aide de la bibliothèque d’authentification Microsoft (MSAL).

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 la clé de Registre est définie sur une valeur entière différente de zéro ou -UseSystemBrowser si le paramètre a truela valeur , 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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.