Connect-SPOService

Módulo:: Microsoft.Online.SharePoint.PowerShell

Se aplica a:: SharePoint Online

Conecta el administrador de SharePoint Online o el administrador de SharePoint Embedded a una conexión de SharePoint Online (el Centro de administración de SharePoint Online). Este cmdlet debe ejecutarse antes de que se puedan ejecutar otros cmdlets de SharePoint Online.

Sintaxis

Connect-SPOService
       [-Url] <UrlCmdletPipeBind>
       [[-Credential] <CredentialCmdletPipeBind>]
       [[-ClientTag] <String>]
       [-AuthenticationUrl] <String>
       [[-ModernAuth] <Boolean>]
       [[-UseSystemBrowser] <Boolean>]
       [<CommonParameters>]

Connect-SPOService
       [-Url] <UrlCmdletPipeBind>
       [[-Credential] <CredentialCmdletPipeBind>]
       [[-ClientTag] <String>]
       [[-Region] <AADCrossTenantAuthenticationLocation>]
       [[-ModernAuth] <Boolean>]
       [[-UseSystemBrowser] <Boolean>]
       [<CommonParameters>]

Description

El Connect-SPOService cmdlet conecta el administrador de SharePoint Online o el administrador de SharePoint Embedded al Centro de administración de SharePoint Online.

Solo se mantiene una única conexión de servicio de SharePoint Online desde cualquier sesión de Windows PowerShell única. En otras palabras, se trata de una conexión por geolocal dentro de una conexión de administrador de la organización. Al ejecutar el Connect-SPOService cmdlet dos veces, se desconecta implícitamente la conexión anterior. La sesión de Windows PowerShell se establecerá para atender al nuevo administrador de SharePoint Online especificado.

Un administrador de asociado delegado tiene que intercambiar conexiones para distintas organizaciones dentro de la misma sesión de Windows PowerShell.

Debe ser administrador de SharePoint Online o administrador de SharePoint Embedded para ejecutar el cmdlet.

Para obtener permisos y la información más actual sobre Windows PowerShell para SharePoint Online, consulte la documentación en línea en Introducción a SharePoint Online Management Shell.

Ejemplos

-----------------------EJEMPLO 1-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential admin@contoso.com

En el ejemplo 1 se muestra cómo un administrador de SharePoint Online con credenciales admin@contoso.com se conecta a un Centro de administración de SharePoint Online que tiene la dirección URL. <https://contoso-admin.sharepoint.com.>

-----------------------EJEMPLO 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

En el ejemplo 2 se muestra cómo un administrador de SharePoint Online con un nombre de usuario y una contraseña se conecta a un Centro de administración de SharePoint Online que tiene la dirección URL. <https://contoso-admin.sharepoint.com.>

--------------------'---EXAMPLE 3-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com

Consultas para las credenciales. Esto es necesario si la cuenta usa la autenticación multifactor.

-----------------------EJEMPLO 4-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR

Se conecta a un Centro de administración de SharePoint Online que especifica la región.

-----------------------EJEMPLO 5-----------------------------

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

Conexión al servicio SPO con la marca ModernAuth.

-----------------------EJEMPLO 6-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true

Se autentica mediante la Biblioteca de autenticación de Microsoft (MSAL) y se conecta al Centro de administración de SharePoint Online si la autenticación se realiza correctamente.

Parámetros

-AuthenticationUrl

Ubicación para Microsoft Entra servicio de autenticación entre inquilinos. Opcionalmente, se puede usar si se usa el servicio de autenticación entre inquilinos no predeterminado.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	SharePoint Online

-ClientTag

Permite anexar una etiqueta de cliente a una etiqueta de cliente existente. Se usa opcionalmente en el tráfico http de CSOM para identificar el script o la solución usados.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	SharePoint Online

-Credential

Especifica las credenciales que se van a usar para conectar. Si no hay ninguna credencial presente, un diálogo solicitará las credenciales. Las credenciales deben ser las de un administrador de SharePoint Online que pueda acceder al sitio del Centro de administración de SharePoint Online.

Tipo:	CredentialCmdletPipeBind
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False
Se aplica a:	SharePoint Online

-ModernAuth

Garantiza que los cmdlets de administración de inquilinos de SharePoint Online se puedan conectar al servicio mediante protocolos TLS modernos.

Para usarlo, también debe proporcionar el parámetro AuthenticationUrl .

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	SharePoint Online

-Region

Los valores válidos son: Predeterminado | ITAR | Alemania | China

El valor predeterminado es "default".

Nota: El valor de ITAR es solo para las tenencias de GCC High y DoD.

Tipo:	AADCrossTenantAuthenticationLocation
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	SharePoint Online

-Url

Especifica la dirección URL del sitio del Centro de administración de SharePoint Online.

Tipo:	UrlCmdletPipeBind
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False
Se aplica a:	SharePoint Online

-UseSystemBrowser

Se usa para autenticar al usuario mediante la Biblioteca de autenticación de Microsoft (MSAL).

Tipo:	Boolean
Posición:	5
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	SharePoint Online