Connect-SPOService

  • Référence
Module:
Microsoft.Online.SharePoint.PowerShell
S’applique à:
SharePoint Online

Connecte un administrateur SharePoint Online ou un administrateur général à 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.

Syntax

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

Description

L’applet Connect-SPOService de commande connecte un administrateur SharePoint Online ou un administrateur général 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 connexion par zone géographique au sein d’une connexion d’administrateur d’organisation. 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 général pour exécuter le cmdlet.

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 ou un administrateur général disposant d’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 ou un administrateur général 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

Demande des 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.

Paramètres

-AuthenticationUrl

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-ClientTag

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é.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Credential

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 ou d’un administrateur général qui peut accéder au site du Centre d’administration SharePoint Online.

Type:CredentialCmdletPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-ModernAuth

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 .

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Region

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.

Type:AADCrossTenantAuthenticationLocation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Url

Spécifie l’URL du site du Centre d’administration SharePoint Online.

Type:UrlCmdletPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online