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 |