Connect-SPOService
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
AuthenticationCertificate
Connect-SPOService
-Url <UrlCmdletPipeBind>
-ClientId <String>
-TenantId <String>
[-ClientTag <String>]
[-Region <AADCrossTenantAuthenticationLocation>]
[-AuthenticationUrl <String>]
[-Certificate <X509Certificate2>]
[-CertificatePath <String>]
[-CertificateThumbprint <String>]
[-CertificatePassword <SecureString>]
[<CommonParameters>]
AuthenticationLocation
Connect-SPOService
-Url <UrlCmdletPipeBind>
[-Credential <CredentialCmdletPipeBind>]
[-ClientTag <String>]
[-Region <AADCrossTenantAuthenticationLocation>]
[-ModernAuth <Boolean>]
[-UseSystemBrowser <Boolean>]
[<CommonParameters>]
AuthenticationUrl
Connect-SPOService
-Url <UrlCmdletPipeBind>
-AuthenticationUrl <String>
[-Credential <CredentialCmdletPipeBind>]
[-ClientTag <String>]
[-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.>
EJEMPLO 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.
EJEMPLO 7
$password = Read-Host -Prompt "Enter certificate password" -AsSecureString
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password
Conéctese al servicio SharePoint Online mediante una identidad de aplicación y una ruta de acceso de archivo de certificado, con una contraseña opcional.
EJEMPLO 8
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"
Conéctese al servicio SharePoint Online mediante una identidad de aplicación y una huella digital de certificado.
EJEMPLO 9
$thumbprint = "3F2A5C9D4E7B8A1234567890ABCDEF1234567890"
$cert = Get-ChildItem Cert:\LocalMachine\My\$thumbprint
Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -Certificate $cert
Conéctese al servicio SharePoint Online mediante una identidad de aplicación y un objeto de certificado.
Parámetros
-AuthenticationUrl
Aplicable: SharePoint Online
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.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationUrl
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Certificate
Aplicable: SharePoint Online
Certificado X.509 usado durante la autenticación.
Propiedades de parámetro
| Tipo: | X509Certificate2 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationCertificate
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-CertificatePassword
Aplicable: SharePoint Online
Contraseña del archivo de certificado.
Propiedades de parámetro
| Tipo: | SecureString |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationCertificate
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-CertificatePath
Aplicable: SharePoint Online
Ruta de acceso al archivo de certificado .pfx local.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationCertificate
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-CertificateThumbprint
Aplicable: SharePoint Online
Huella digital del certificado en el almacén de certificados del usuario actual.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationCertificate
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ClientId
Aplicable: SharePoint Online
Identificador de cliente de la aplicación.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | ApplicationId |
Conjuntos de parámetros
AuthenticationCertificate
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ClientTag
Aplicable: SharePoint Online
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.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Credential
Aplicable: SharePoint Online
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.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationUrl
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
AuthenticationLocation
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ModernAuth
Aplicable: SharePoint Online
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 .
Propiedades de parámetro
| Tipo: | System.Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationUrl
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
AuthenticationLocation
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Region
Aplicable: SharePoint Online
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.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.AADCrossTenantAuthenticationLocation |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationLocation
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
AuthenticationCertificate
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TenantId
Aplicable: SharePoint Online
Identificador de inquilino al que se va a conectar.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationCertificate
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Url
Aplicable: SharePoint Online
Especifica la dirección URL del sitio del Centro de administración de SharePoint Online.
Propiedades de parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-UseSystemBrowser
Aplicable: SharePoint Online
Se usa para autenticar al usuario mediante la Biblioteca de autenticación de Microsoft (MSAL).
Nota:
Para evitar agregar el -UseSystemBrowser parámetro cada vez que ejecute Connect-SPOService, puede establecer una clave del Registro en su lugar.
Establezca la clave del UseSystemBrowser Registro (tipo REG_DWORD) en: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\
Si una clave del Registro se establece en un valor entero distinto de cero o -UseSystemBrowser el parámetro está establecido trueen , el flujo de autenticación usará el explorador del sistema para el inicio de sesión.
Propiedades de parámetro
| Tipo: | System.Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AuthenticationUrl
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
AuthenticationLocation
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.