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
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>]
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.
BEISPIEL 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
Stellen Sie eine Verbindung mit dem SharePoint Online-Dienst her, indem Sie eine App-Identität und einen Zertifikatdateipfad mit einem optionalen Kennwort verwenden.
BEISPIEL 8
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"
Stellen Sie mithilfe einer App-Identität und eines Zertifikatfingerabdrucks eine Verbindung mit dem SharePoint Online-Dienst her.
BEISPIEL 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
Stellen Sie mithilfe einer App-Identität und eines Zertifikatobjekts eine Verbindung mit dem SharePoint Online-Dienst her.
Parameter
-AuthenticationUrl
Anwendbar: SharePoint Online
Speicherort für Microsoft Entra mandantenübergreifenden Authentifizierungsdienst. Kann optional verwendet werden, wenn ein nicht standardmäßiger mandantenübergreifender Authentifizierungsdienst verwendet wird.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationUrl
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Certificate
Anwendbar: SharePoint Online
Ein X.509-Zertifikat, das während der Authentifizierung verwendet wird.
Parametereigenschaften
| Typ: | X509Certificate2 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationCertificate
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CertificatePassword
Anwendbar: SharePoint Online
Das Kennwort für die Zertifikatdatei.
Parametereigenschaften
| Typ: | SecureString |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationCertificate
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CertificatePath
Anwendbar: SharePoint Online
Der Pfad zur lokalen PFX-Zertifikatdatei.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationCertificate
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CertificateThumbprint
Anwendbar: SharePoint Online
Der Fingerabdruck des Zertifikats im Zertifikatspeicher des aktuellen Benutzers.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationCertificate
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ClientId
Anwendbar: SharePoint Online
Die Client-ID der Anwendung.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | ApplicationId |
Parametersätze
AuthenticationCertificate
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ClientTag
Anwendbar: SharePoint Online
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.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Anwendbar: SharePoint Online
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.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationUrl
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
AuthenticationLocation
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ModernAuth
Anwendbar: SharePoint Online
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.
Parametereigenschaften
| Typ: | System.Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationUrl
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
AuthenticationLocation
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Region
Anwendbar: SharePoint Online
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.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.PowerShell.AADCrossTenantAuthenticationLocation |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationLocation
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
AuthenticationCertificate
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-TenantId
Anwendbar: SharePoint Online
Die Mandanten-ID, mit der eine Verbindung hergestellt werden soll.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationCertificate
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Url
Anwendbar: SharePoint Online
Gibt die URL der SharePoint Online Administration Center-Website an.
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UseSystemBrowser
Anwendbar: SharePoint Online
Wird verwendet, um den Benutzer mithilfe der Microsoft Authentication Library (MSAL) zu authentifizieren.
Hinweis
Um das Hinzufügen des -UseSystemBrowser Parameters bei jeder Ausführung Connect-SPOServicevon zu vermeiden, können Sie stattdessen einen Registrierungsschlüssel festlegen.
Legen Sie den UseSystemBrowser Registrierungsschlüssel (Typ REG_DWORD) unter fest: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\
Wenn ein Registrierungsschlüssel auf einen ganzzahligen Wert ungleich 0 festgelegt ist oder -UseSystemBrowser der Parameter auf truefestgelegt ist, verwendet der Authentifizierungsablauf den Systembrowser für die Anmeldung.
Parametereigenschaften
| Typ: | System.Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationUrl
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
AuthenticationLocation
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.