Connect-SPOService

  • Referencia
Módulo:
Microsoft.Online.SharePoint.PowerShell
Se aplica a:
SharePoint Online

Conecta un administrador de SharePoint Online o un administrador global 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.

Syntax

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

Description

El Connect-SPOService cmdlet conecta un administrador de SharePoint Online o un administrador global 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 delegado de asociados tiene que intercambiar conexiones para distintas organizaciones dentro de la misma sesión de Windows PowerShell.

Se requiere ser un administrador de SharePoint Online o un administrador global 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 o un administrador global 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 o un administrador global 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.

-----------------------EJEMPLO 3-----------------------------

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

Solicita 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.

Parámetros

-AuthenticationUrl

Ubicación del servicio de autenticación entre inquilinos de AAD. Opcionalmente, se puede usar si se usa el servicio de autenticación entre inquilinos no predeterminado.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 de un administrador de SharePoint Online o un administrador global que pueda acceder al sitio del Centro de administración de SharePoint Online.

Type:CredentialCmdletPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to: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 .

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Type:AADCrossTenantAuthenticationLocation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Url

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

Type:UrlCmdletPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online