Connect-SPOService
Verbindet einen SharePoint-Administrator oder einen SharePoint Embedded-Administrator mit dem SharePoint Admin Center. Sie müssen dieses Cmdlet ausführen, bevor Sie andere SharePoint Online-Cmdlets ausführen.
Syntax
AuthenticationCertificate
Connect-SPOService
[-Url] <UrlCmdletPipeBind>
[[-ClientTag] <String>]
-ClientId <String>
-TenantId <String>
[-Region <AADCrossTenantAuthenticationLocation>]
[-AuthenticationUrl <String>]
[-Certificate <X509Certificate2>]
[-CertificatePath <String>]
[-CertificateThumbprint <String>]
[-CertificatePassword <SecureString>]
[<CommonParameters>]
AuthenticationLocation
Connect-SPOService
[-Url] <UrlCmdletPipeBind>
[[-Credential] <CredentialCmdletPipeBind>]
[[-ClientTag] <String>]
[[-ModernAuth] <Boolean>]
[[-UseSystemBrowser] <Boolean>]
[-Region <AADCrossTenantAuthenticationLocation>]
[<CommonParameters>]
AuthenticationManagedIdentity
Connect-SPOService
-Url <UrlCmdletPipeBind>
[-ClientTag <String>]
[-ManagedIdentity]
[-ManagedIdentityType <ManagedIdentityType>]
[-ManagedIdentityClientId <String>]
[<CommonParameters>]
AuthenticationUrl
Connect-SPOService
[-Url] <UrlCmdletPipeBind>
[[-Credential] <CredentialCmdletPipeBind>]
[[-ClientTag] <String>]
[[-ModernAuth] <Boolean>]
[[-UseSystemBrowser] <Boolean>]
-AuthenticationUrl <String>
[<CommonParameters>]
Beschreibung
Dieses Cmdlet verbindet einen SharePoint-Administrator oder einen SharePoint Embedded-Administrator mit dem SharePoint Admin Center. Pro Windows PowerShell-Sitzung und geografischem Raum innerhalb einer organization wird nur eine einzige SharePoint Online-Dienstverbindung unterstützt. Wenn Sie dieses Cmdlet erneut ausführen, wird die bestehende Verbindung automatisch getrennt und durch die neue Verbindung ersetzt. Die PowerShell-Sitzung verwendet dann den neu angegebenen Administratorkontext. Delegierte Partneradministratoren müssen die Verbindungen wechseln, wenn sie mehrere Organisationen innerhalb derselben PowerShell-Sitzung verwalten. Um dieses Cmdlet ausführen zu können, müssen Sie SharePoint-Administrator oder SharePoint Embedded-Administrator sein. Informationen zu den Berechtigungsanforderungen und die neuesten Anleitungen finden Sie in der Dokumentation zur Einführung in die SharePoint Online-Verwaltungsshell.
Beispiele
BEISPIEL 1
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
Dieses Beispiel zeigt, wie ein SharePoint-Administrator, der admin@contoso.com das Konto verwendet, eine Verbindung mit dem SharePoint Admin Center unter https://contoso-admin.sharepoint.comherstellt.
BEISPIEL 2
$username = "admin@contoso.sharepoint.com"
$password = Read-Host -Prompt "Enter user password" -AsSecureString
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $userName, $password
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred
Dieses Beispiel zeigt, wie ein SharePoint-Administrator eine Verbindung mit dem SharePoint Admin Center https://contoso-admin.sharepoint.com herstellt, indem er ein Anmeldeinformationsobjekt aus einem Benutzernamen und einem Kennwort erstellt.
BEISPIEL 3
Connect-SPOService -Url https://contoso-admin.sharepoint.com
In diesem Beispiel werden Anmeldeinformationen eingegeben. Dieser Ansatz ist erforderlich, wenn das Konto die mehrstufige Authentifizierung verwendet.
BEISPIEL 4
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR
Dieses Beispiel stellt eine Verbindung mit dem SharePoint Admin Center her, indem die Authentifizierungsregion angegeben wird.
BEISPIEL 5
Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations
Dieses Beispiel stellt mithilfe der modernen Authentifizierung eine Verbindung mit dem SharePoint Admin Center her.
BEISPIEL 6
Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true
In diesem Beispiel wird die Authentifizierung mithilfe der Microsoft-Authentifizierungsbibliothek (MSAL) vorgenommen und nach erfolgreicher Authentifizierung eine Verbindung mit dem SharePoint Admin Center hergestellt.
BEISPIEL 7
$password = Read-Host -Prompt "Enter certificate password" -AsSecureString
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password
Dieses Beispiel stellt eine Verbindung mit dem SharePoint Admin Center her, indem eine App-Identität und ein Zertifikatdateipfad mit einem optionalen Zertifikatkennwort verwendet werden.
BEISPIEL 8
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"
Dieses Beispiel stellt über eine App-Identität und einen Zertifikatfingerabdruck eine Verbindung mit dem SharePoint Admin Center 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 -TenantId 11111111-1111-1111-1111-111111111111 -Certificate $cert
Dieses Beispiel stellt mithilfe einer App-Identität und eines Zertifikatobjekts eine Verbindung mit dem SharePoint Admin Center her.
BEISPIEL 10
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ManagedIdentity
Dieses Beispiel stellt mithilfe einer systemseitig zugewiesenen verwalteten Identität eine Verbindung mit dem SharePoint Admin Center her.
BEISPIEL 11
Connect-SPOService -url https://contoso-admin.sharepoint.com -ManagedIdentity -ManagedIdentityType UserAssigned -ManagedIdentityClientId 00000000-0000-0000-0000-000000000000
Dieses Beispiel stellt mithilfe einer benutzerseitig zugewiesenen verwalteten Identität eine Verbindung mit dem SharePoint Admin Center her.
Parameter
-AuthenticationUrl
Anwendbar: SharePoint Online
Gibt die URL für den mandantenübergreifenden Microsoft Entra-Authentifizierungsdienst an. Verwenden Sie diesen Parameter, wenn ein nicht standardmäßiger mandantenübergreifender Authentifizierungsendpunkt erforderlich ist.
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
Gibt das für die Authentifizierung verwendete X.509-Zertifikat an.
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
Gibt das Kennwort für die Zertifikatdatei an.
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
Gibt den Pfad zur lokalen .pfx Zertifikatsdatei an.
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
Gibt den Fingerabdruck des Zertifikats im Zertifikatspeicher des aktuellen Benutzers an.
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
Gibt die Client-ID der Anwendung an.
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
Fügt dem CSOM-HTTP-Datenverkehr optional ein Client-Tag hinzu, um das aufrufende Skript oder die aufrufende 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 für die Verbindung verwendet werden. Wenn Sie keine Anmeldeinformationen angeben, werden Sie aufgefordert, diese einzugeben. Die Anmeldeinformationen müssen einem Administrator gehören, der Zugriff auf das SharePoint Admin Center hat.
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 |
-ManagedIdentity
Anwendbar: SharePoint Online
Gibt an, dass die Verbindung eine verwaltete Identität anstelle einer benutzer- oder zertifikatbasierten Authentifizierung verwendet.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationManagedIdentity
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ManagedIdentityClientId
Anwendbar: SharePoint Online
Gibt die Client-ID einer benutzerseitig zugewiesenen verwalteten Identität an, die für die Authentifizierung verwendet werden soll.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationManagedIdentity
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ManagedIdentityType
Anwendbar: SharePoint Online
Gibt den Typ der verwalteten Identität an, die bei der Authentifizierung verwendet werden soll. Wenn nicht angegeben, wird der standardmäßige verwaltete Identitätstyp verwendet.
Parametereigenschaften
| Typ: | ManagedIdentityType |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AuthenticationManagedIdentity
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ModernAuth
Anwendbar: SharePoint Online
Aktiviert die moderne Authentifizierung beim Herstellen einer Verbindung mit SharePoint-Verwaltungs-Cmdlets.
Wenn Sie diesen Parameter 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
Gibt die Authentifizierungsregion an. Gültige Werte sind: Default, ITAR, Germanyund 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
Gibt die ID des Mandanten an, mit dem 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 des SharePoint Admin Centers 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
Verwendet die Microsoft Authentication Library (MSAL), um den Benutzer mithilfe des Systembrowsers zu authentifizieren.
Hinweis
Um zu vermeiden, dass der -UseSystemBrowser Parameter bei jeder Ausführung Connect-SPOServicehinzugefügt wird, können Sie stattdessen einen Registrierungsschlüssel festlegen.
Legen Sie den UseSystemBrowser Registrierungsschlüssel (Typ REG_DWORD) unter: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\
Wenn einer der Registrierungsschlüssel auf einen ganzzahligen Wert ungleich Null festgelegt ist oder -UseSystemBrowser der Parameter auf truefestgelegt ist, verwendet der Authentifizierungsfluss 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.