Hinweis: Für die PowerShell-Integration ist ein ShareGate Migrate Pro- oder Enterprise-Abonnement erforderlich. Sie ist im Essentials-Plan nicht verfügbar.
Befehl
Connect-Site
Beschreibung
Der Befehl zum Herstellen einer Verbindung mit einer SharePoint-Site.
Hinweis: Seit Ende Januar 2026 hat Microsoft begonnen, das IDCRL-Cookie schrittweise abzuschaffen. Das bedeutet, dass in den meisten Microsoft 365-Mandanten nur noch die Methoden Browser und Modern Authentication mit den Parametern -Browser und -ModernAuth funktionieren. Weitere Informationen zu dieser Änderung finden Sie unter Wichtige Änderung bei der Authentifizierung als „anderer Benutzer“ für Microsoft 365.
Beispiele
Verbindung zur SharePoint Online-Site mit Modern Authentication in Microsoft 365 herstellen
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth
Verbindung zur SharePoint Online-Site mit Modern Authentication und UserName in Microsoft 365 herstellen
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -UserName [email protected]
Hinweis: Sie werden aufgefordert, Ihr Kennwort im PowerShell-Fenster einzugeben.
Verbindung zur SharePoint Online-Site mit Modern Authentication, UserName und Kennwort in Microsoft 365 herstellen
$mypassword = ConvertTo-SecureString "mypassword" -AsPlainText -Force
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -UserName [email protected] -Password $mypassword
Verbindung zur SharePoint-Site mit den Anmeldeinformationen des aktuellen Benutzers herstellen
Connect-Site -Url "http://myfarm1/sites/mysitecollection"
Verbindung zur SharePoint-Site mit einem Benutzernamen herstellen
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Username "myusername"
Verbindung zur SharePoint-Site mit Benutzername und Kennwort herstellen
$mypassword = ConvertTo-SecureString 'mypassword' -AsPlainText -Force
$mysite = Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Username "myusername" -Password $mypassword
Verbindung zur SharePoint-Site ohne Single Sign-On (SSO) herstellen
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser -DisableSSO
Verbindung zur SharePoint-Site mit Proxyeinstellungen herstellen
$proxySettings = New-ProxySettings -Server myproxyserver -Port 888
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -ProxySettings $proxySettings
Verbindung zur SharePoint-Site mit Browser Authentication herstellen
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser
Hinweis: Um zu vermeiden, dass Sie Ihre Anmeldeinformationen bei Verwendung einer foreach-Schleife mehrfach eingeben müssen, siehe Anmeldeinformationen einer vorherigen Browserverbindung verwenden.
Verbindung zur SharePoint-Site mit Browser Authentication und Proxyeinstellungen herstellen
$proxySettings = New-ProxySettings -Server myproxyserver -Port 888
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser -ProxySettings $proxySettings
Verbindung zur SharePoint-Site mit Anmeldeinformationen einer vorhandenen Verbindung herstellen
$connection = Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser
Connect-Site -Url "http://myfarm1/sites/anothersitecollection" -UseCredentialsFrom $connection
Verbindung zur SharePoint-Site mit Anmeldeinformationen einer vorhandenen Mandantenverbindung herstellen
$connection = Connect-Tenant -Domain "mytenantdomain" -Browser
Connect-Site -Url "http://mytenantdomain/sites/mysitecollection" -UseCredentialsFrom $connection
Verbindung herstellen und die SharePoint-Site-Verbindung zum ShareGate Migrate Explorer hinzufügen
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -AddToExplorer
Verbindung zur SharePoint-Site mit einer Eingabeaufforderung zur Eingabe von Benutzername und Kennwort herstellen
$Credentials = Get-Credential
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Credential $Credentials
Hinweis: Get-Credential ist ein Microsoft PowerShell-Befehl. Wenn Sie ihn in Ihrem Skript verwenden, öffnet er auf Ihrer Arbeitsstation eine Eingabeaufforderung zur Eingabe Ihrer Anmeldeinformationen und speichert diese in einer Variablen.
Mit einer gespeicherten SharePoint-Verbindung eine Verbindung zu SharePoint herstellen
$connection = Get-SharePointConnection -Id 01c0ebab-a17e-4ae3-9caf-ba09f05f2970
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -UseConnection $connection
Verbindung zu SharePoint herstellen und die SharePoint-Verbindung speichern
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -SaveConnection
Syntax
Connect-Site
-Url <String>
[-AllowConnectionFallback <SwitchParameter>]
[-ProxySettings <ProxySettings>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-Credential <PSCredential>
[-AllowConnectionFallback <SwitchParameter>]
[-ProxySettings <ProxySettings>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-UserName <String>
-Password <SecureString>
[-AllowConnectionFallback <SwitchParameter>]
[-ModernAuth <SwitchParameter>]
[-ProxySettings <ProxySettings>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-UseCredentialsFrom <ConnectionEntity>
[-AllowConnectionFallback <SwitchParameter>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-Browser <SwitchParameter>
[-AllowConnectionFallback <SwitchParameter>]
[-DisableSSO <SwitchParameter>]
[-ProxySettings <ProxySettings>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-ModernAuth <SwitchParameter>
[-AllowConnectionFallback <SwitchParameter>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-UseConnection <SharePointConnection>
[-AllowConnectionFallback <SwitchParameter>]
[-AddToExplorer <SwitchParameter>]
Connect-Site
-Url <String>
-AzureApplication <AzureApplication>
[-AllowConnectionFallback <SwitchParameter>]
[-TenantId <String>]
[-AllowMissingPermissions <SwitchParameter>]
Parameter
-AddToExplorer <SwitchParameter>
Fügt die Verbindung zum ShareGate Explorer hinzu.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | (All) |
Aliase | None |
-AllowConnectionFallback <SwitchParameter>
Ermöglicht ShareGate, in der Hierarchie nach oben zu gehen und nach Verbindungsoptionen zu suchen, wenn keine Verbindung zur angegebenen URL hergestellt werden kann.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | (All) |
Aliase | None |
-AllowMissingPermissions <SwitchParameter>
Ermöglicht die Fortsetzung der Verbindung, wenn der Azure-Anwendung eine oder mehrere Berechtigungen fehlen, die normalerweise für SharePoint, Gruppen, Teams oder Planner erforderlich sind. Es wird eine Warnung ausgegeben, die die fehlenden Berechtigungen auflistet.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | UseCredentialsFrom, AzureApplication |
Aliase | None |
-AzureApplication <AzureApplication>
Gibt die für die Authentifizierung verwendete Azure-Anwendung an. Erstellen Sie eine mit New-AzureApplication.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | True (ByValue) |
Platzhalterzeichen zulässig? | False |
Parametersatzname | AzureApplication |
Aliase | None |
-Browser <SwitchParameter>
Verwendet die Browserauthentifizierung.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | Browser |
Aliase | None |
-Credential <PSCredential>
Gibt die Anmeldeinformationen an.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | True (ByValue, ByPropertyName) |
Platzhalterzeichen zulässig? | False |
Parametersatzname | Credential |
Aliase | None |
-DisableSSO <SwitchParameter>
Deaktiviert die automatische Anmeldung, um sich mit einem anderen Benutzerkonto bei einer Microsoft 365-Site anzumelden.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | Browser |
Aliase | None |
-ModernAuth <SwitchParameter>
Verwendet die moderne Authentifizierung.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | ModernManualAuth, ModernAuth |
Aliase | None |
Hinweis: Derzeit funktioniert -ModernAuth nur bei der Verbindung mit SharePoint-Sites und OneDrive for Business. Für die Verbindung mit anderen Microsoft 365-Diensten, wie Teams oder Exchange-Postfächern, müssen Sie -Browser verwenden.
-Password <SecureString>
Gibt das Kennwort an. Verwenden Sie einfache Anführungszeichen ('), um die Zeichenfolge genau so an den Befehl zu übergeben, wie Sie sie eingeben.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | Manual |
Aliase | None |
-ProxySettings <ProxySettings>
Legt die Proxyeinstellungen für die Verbindung mit der SharePoint-Site fest.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | True (ByValue, ByPropertyName) |
Platzhalterzeichen zulässig? | False |
Parametersatzname | Default, Credential, Manual, Browser |
Aliase | None |
-SaveConnection <SwitchParameter>
Speichert die Verbindung nach dem Verbindungsaufbau im Connection Manager.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | Default, Credential, Manual, UseCredentialsFrom, Browser, ModernAuth |
Aliase | None |
-TenantId <String>
Gibt die für die Verbindung verwendete Mandanten-ID an.
Erforderlich? | False |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | AzureApplication |
Aliase | None |
-Url <String>
Legt die URL der SharePoint-Site fest.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | (All) |
Aliase | None |
-UseConnection <SharePointConnection>
Gibt eine gespeicherte SharePoint-Verbindung an, die für die Authentifizierung verwendet wird. Rufen Sie eine solche Verbindung mit Get-SharePointConnection ab.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | UseConnection |
Aliase | None |
-UseCredentialsFrom <ConnectionEntity>
Verwendet die Anmeldeinformationen einer anderen Verbindung.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | UseCredentialsFrom |
Aliase | None |
-UserName <String>
Gibt den Benutzernamen an.
Erforderlich? | True |
Standardwert | None |
Pipelineeingabe zulässig? | False |
Platzhalterzeichen zulässig? | False |
Parametersatzname | Manual |
Aliase | None |
Dieser Artikel wurde mit künstlicher Intelligenz übersetzt. Bei Unklarheiten konsultieren Sie bitte die englische Originalversion.
