Nota: La integración de PowerShell requiere una suscripción Pro o Enterprise de ShareGate Migrate. No está disponible en el plan Essentials.

Command

Connect-Site

Description

El comando para conectarte a un sitio de SharePoint.

Nota: A partir de finales de enero de 2026, Microsoft comenzó a retirar la cookie IDCRL, lo que significa que en la mayoría de los inquilinos de Microsoft 365 solo funcionarán los métodos Browser y Modern authentication con los parámetros -Browser y -ModernAuth. Para saber más sobre este cambio, consulta Cambio importante en la autenticación de "Other user" para Microsoft 365.

Examples

Conéctate al sitio de SharePoint Online mediante autenticación moderna en Microsoft 365

$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth

Conéctate al sitio de SharePoint Online mediante autenticación moderna con UserName en Microsoft 365

$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -UserName [email protected]

Nota: Se te pedirá que ingreses tu contraseña en la ventana de PowerShell.

Conéctate al sitio de SharePoint Online mediante autenticación moderna con UserName y contraseña en Microsoft 365

$mypassword = ConvertTo-SecureString "mypassword" -AsPlainText -Force
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -UserName [email protected] -Password $mypassword

Conéctate al sitio de SharePoint con las credenciales del usuario actual

Connect-Site -Url "http://myfarm1/sites/mysitecollection"

Conéctate al sitio de SharePoint con un nombre de usuario

Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Username "myusername"

Conéctate al sitio de SharePoint con nombre de usuario y contraseña

$mypassword = ConvertTo-SecureString 'mypassword' -AsPlainText -Force
$mysite = Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Username "myusername" -Password $mypassword

Conéctate al sitio de SharePoint sin inicio de sesión único (SSO)

Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser -DisableSSO

Conéctate al sitio de SharePoint con configuración de proxy

$proxySettings = New-ProxySettings -Server myproxyserver -Port 888
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -ProxySettings $proxySettings

Conéctate al sitio de SharePoint mediante autenticación por navegador

Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser

Nota: Para evitar ingresar tus credenciales varias veces cuando usas un bucle foreach, consulta Usar las credenciales de una conexión de explorador anterior.

Conéctate al sitio de SharePoint mediante autenticación por navegador con configuración de proxy

$proxySettings = New-ProxySettings -Server myproxyserver -Port 888
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser -ProxySettings $proxySettings

Conéctate al sitio de SharePoint usando las credenciales de una conexión existente

$connection = Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser
Connect-Site -Url "http://myfarm1/sites/anothersitecollection" -UseCredentialsFrom $connection

Conéctate al sitio de SharePoint usando las credenciales de una conexión de inquilino existente

$connection = Connect-Tenant -Domain "mytenantdomain" -Browser
Connect-Site -Url "http://mytenantdomain/sites/mysitecollection" -UseCredentialsFrom $connection

Conéctate y agrega la conexión del sitio de SharePoint al ShareGate Migrate Explorer

Connect-Site -Url "http://myfarm1/sites/mysitecollection" -AddToExplorer

Conéctate al sitio de SharePoint mediante un aviso para ingresar tu nombre de usuario y contraseña

$Credentials = Get-Credential
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Credential $Credentials

Nota: Get-Credential es un comando de Microsoft PowerShell. Cuando lo usas en tu script, abre un aviso en tu estación de trabajo para ingresar tus credenciales y almacenarlas en una variable.

Conéctate a SharePoint usando una conexión de SharePoint guardada

$connection = Get-SharePointConnection -Id 01c0ebab-a17e-4ae3-9caf-ba09f05f2970
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -UseConnection $connection

Conéctate a SharePoint y guarda la conexión de SharePoint

$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>]

Parameters

-AddToExplorer <SwitchParameter>

Agrega la conexión al ShareGate Explorer.

¿Obligatorio?	False
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	(All)
Alias	None

-AllowConnectionFallback <SwitchParameter>

Permite que ShareGate busque opciones de conexión subiendo en la jerarquía si no puede conectarse a la URL especificada.

¿Obligatorio?	False
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	(All)
Alias	None

-AllowMissingPermissions <SwitchParameter>

Permite que la conexión continúe cuando a la aplicación de Azure le faltan uno o más permisos normalmente necesarios para SharePoint, Groups, Teams o Planner. Se emite una advertencia con la lista de los permisos faltantes.

¿Obligatorio?	False
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	UseCredentialsFrom, AzureApplication
Alias	None

-AzureApplication <AzureApplication>

Especifica la aplicación de Azure que se usa para autenticar. Crea una con New-AzureApplication.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	True (ByValue)
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	AzureApplication
Alias	None

-Browser <SwitchParameter>

Usa autenticación mediante navegador.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	Browser
Alias	None

-Credential <PSCredential>

Especifica las credenciales.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	True (ByValue, ByPropertyName)
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	Credential
Alias	None

-DisableSSO <SwitchParameter>

Desactiva la función de inicio de sesión automático para conectarte a un sitio de Microsoft 365 con otra cuenta de usuario.

¿Obligatorio?	False
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	Browser
Alias	None

-ModernAuth <SwitchParameter>

Usa autenticación moderna.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	ModernManualAuth, ModernAuth
Alias	None

Nota: Por el momento, -ModernAuth solo funciona al conectarte a sitios de SharePoint y OneDrive for Business. Deberás usar -Browser para conectarte a otros servicios de Microsoft 365, como Teams o buzones de Exchange.

-Password <SecureString>

Especifica la contraseña. Usa comillas simples (') para pasar la cadena al comando exactamente como la escribiste.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	Manual
Alias	None

-ProxySettings <ProxySettings>

Establece la configuración de proxy para conectarte al sitio de SharePoint.

¿Obligatorio?	False
Valor predeterminado	None
¿Acepta entrada de canalización?	True (ByValue, ByPropertyName)
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	Default, Credential, Manual, Browser
Alias	None

-SaveConnection <SwitchParameter>

Guarda la conexión en Connection manager después de conectarte.

¿Obligatorio?	False
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	Default, Credential, Manual, UseCredentialsFrom, Browser, ModernAuth
Alias	None

-TenantId <String>

Especifica el ID de inquilino que se usa para conectarte.

¿Obligatorio?	False
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	AzureApplication
Alias	None

-Url <String>

Establece la URL del sitio de SharePoint.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	(All)
Alias	None

-UseConnection <SharePointConnection>

Especifica una conexión de SharePoint guardada para usar en la autenticación. Recupérala con Get-SharePointConnection.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	UseConnection
Alias	None

-UseCredentialsFrom <ConnectionEntity>

Usa las credenciales de otra conexión.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	UseCredentialsFrom
Alias	None

-UserName <String>

Especifica el nombre de usuario.

¿Obligatorio?	True
Valor predeterminado	None
¿Acepta entrada de canalización?	False
¿Acepta caracteres comodín?	False
Nombre del conjunto de parámetros	Manual
Alias	None

Este artículo fue traducido con inteligencia artificial. En caso de duda, consulta la versión original en inglés.