Zum Hauptinhalt springen

Connect-Site

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.

Hat dies deine Frage beantwortet?