Freigeben über


Connect-SPOService

Verbindet den SharePoint Online-Administrator oder den SharePoint Embedded-Administrator mit einer SharePoint Online-Verbindung (das SharePoint Online-Verwaltungscenter). Dieses Cmdlet muss ausgeführt werden, bevor andere SharePoint Online-Cmdlets ausgeführt werden können.

Syntax

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

Beschreibung

Das Connect-SPOService Cmdlet verbindet den SharePoint Online-Administrator oder den SharePoint Embedded-Administrator mit dem SharePoint Online-Verwaltungscenter.

Nur eine einzelne SharePoint Online-Dienstverbindung wird von einer einzelnen Windows PowerShell Sitzung verwaltet. Anders ausgedrückt: Dies ist eine geografische Verbindung innerhalb einer organization Administratorverbindung. Wenn Sie das Connect-SPOService Cmdlet zweimal ausführen, wird die vorherige Verbindung implizit getrennt. Die Windows PowerShell Sitzung wird so festgelegt, dass sie dem neuen angegebenen SharePoint Online-Administrator dient.

Ein delegierter Partneradministrator muss verbindungen für verschiedene Organisationen innerhalb derselben Windows PowerShell Sitzung austauschen.

Sie müssen ein SharePoint Online-Administrator oder ein SharePoint Embedded-Administrator sein, um das Cmdlet ausführen zu können.

Angaben zu Berechtigungen sowie die aktuellsten Informationen zu Windows PowerShell für SharePoint Online finden Sie in der Onlinedokumentation unter Einführung in die SharePoint Online-Verwaltungsshell.

Beispiele

-----------------------BEISPIEL 1-----------------------------

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

Beispiel 1 zeigt, wie ein SharePoint Online-Administrator mit Anmeldeinformationen admin@contoso.com eine Verbindung mit einem SharePoint Online-Verwaltungscenter herstellt, das über die URL verfügt. <https://contoso-admin.sharepoint.com.>

-----------------------BEISPIEL 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

Beispiel 2 zeigt, wie ein SharePoint Online-Administrator mit einem Benutzernamen und Kennwort eine Verbindung mit einem SharePoint Online-Verwaltungscenter mit der URL herstellt. <https://contoso-admin.sharepoint.com.>

-------------------- ---BEISPIEL 3-----------------------------

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

Prompts für Anmeldeinformationen. Dies ist erforderlich, wenn das Konto die mehrstufige Authentifizierung verwendet.

-----------------------BEISPIEL 4-----------------------------

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

Stellt eine Verbindung mit einem SharePoint Online-Verwaltungscenter her, das die Region angibt.

-----------------------BEISPIEL 5-----------------------------

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

Herstellen einer Verbindung mit dem SPO-Dienst mit dem ModernAuth-Flag.

-----------------------BEISPIEL 6-----------------------------

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

Authentifiziert sich mithilfe der Microsoft Authentication Library (MSAL) und stellt bei erfolgreicher Authentifizierung eine Verbindung mit dem SharePoint Online Administration Center her.

Parameter

-AuthenticationUrl

Speicherort für Microsoft Entra mandantenübergreifenden Authentifizierungsdienst. Kann optional verwendet werden, wenn ein nicht standardmäßiger mandantenübergreifender Authentifizierungsdienst verwendet wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::SharePoint Online

-ClientTag

Ermöglicht das Anfügen eines Clienttags an ein vorhandenes Clienttag. Wird optional im CSOM-HTTP-Datenverkehr verwendet, um das verwendete Skript oder die verwendete Lösung zu identifizieren.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::SharePoint Online

-Credential

Gibt die Anmeldeinformationen an, die zum Herstellen der Verbindung verwendet werden sollen. Wenn keine Anmeldeinformationen angegeben werden, werden Sie in einem Dialogfeld zur Eingabe der Anmeldeinformationen aufgefordert. Bei den Anmeldeinformationen muss es sich um die Anmeldeinformationen eines SharePoint Online-Administrators handeln, der auf die SharePoint Online Administration Center-Website zugreifen kann.

Typ:CredentialCmdletPipeBind
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::SharePoint Online

-ModernAuth

Stellt sicher, dass SharePoint Online-Mandantenverwaltungs-Cmdlets mithilfe moderner TLS-Protokolle eine Verbindung mit dem Dienst herstellen können.

Um es zu verwenden, müssen Sie auch den AuthenticationUrl-Parameter angeben.

Typ:Boolean
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::SharePoint Online

-Region

Die gültigen Werte sind: Standard | ITAR | Deutschland | China

Der Standardwert ist "default".

Hinweis: Der ITAR-Wert gilt nur für GCC High- und DoD-Mandanten.

Typ:AADCrossTenantAuthenticationLocation
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::SharePoint Online

-Url

Gibt die URL der SharePoint Online Administration Center-Website an.

Typ:UrlCmdletPipeBind
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False
Gilt für::SharePoint Online

-UseSystemBrowser

Wird verwendet, um den Benutzer mithilfe der Microsoft Authentication Library (MSAL) zu authentifizieren.

Typ:Boolean
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False
Gilt für::SharePoint Online