Compartir a través de

Usar cmdlets de PowerShell para que las herramientas de XRM se conecten a Microsoft Dataverse

  • Artículo

Los útiles de XRM le proporcionan los siguientes cmdlets de Windows PowerShell que puede utilizar para conectarse a Dataverse y recuperar las organizaciones a las que el usuario actual tiene acceso: Get-CrmConnection y Get-CrmOrganizations.

Requisitos previos

  • Para usar los cmdlets de los útiles de XRM, necesita la versión 3.0 de PowerShell o posterior. Para comprobar la versión, abra una ventana de PowerShell y ejecute el siguiente comando: $Host

  • Establezca la directiva de ejecución para ejecutar los scripts de PowerShell firmados. Para ello, abra una ventana de PowerShell como administrador y ejecute el siguiente comando: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Adquiera el cmdlet Microsoft.Xrm.Tooling.CrmConnector.PowerShell

Para poder usar cmdlet Microsoft.Xrm.Tooling.CrmConnector.PowerShell tiene que instalarlo. El cmdlet PowerShell de útiles XRM está disponible en la galería de PowerShell aquí. Para descargar instalar el cmdlet

Abra PowerShell o PowerShell ISE en modo de administración, y ejecute el siguiente comando:

Install-Module -Name Microsoft.Xrm.Tooling.CrmConnector.PowerShell

Si instaló el módulo anteriormene, puede actualizarlo con el siguiente comando:

Update-Module -Name Microsoft.Xrm.Tooling.CrmConnector.PowerShell

Ahora está listo para usar el cmdlet Microsoft.Xrm.Tooling.CrmConnector.PowerShell. Para mostrar las funciones que registró, ejecute el comando siguiente en la ventana de PowerShell:

Get-Help “Crm”

Uso del cmdlet para recuperar organizaciones de Dataverse

Use el cmdlet Get-CrmOrganizations para recuperar las organizaciones a las que tiene acceso.

  1. Especifique las credenciales para conectarse a la instancia de Dataverse. Si ejecuta el siguiente comando se le pedirá que escriba su nombre de usuario y contraseña para conectarse a la instancia de Dataverse y se almacenará en la variable $Cred.

    $Cred = Get-Credential

  2. Use el siguiente comando para recuperar sus organizaciones y almacenar la información en la variable $CRMOrgs

    • Si va a conectarse a una instancia de Dataverse:

      $CRMOrgs = Get-CrmOrganizations -Credential $Cred -DeploymentRegion NorthAmerica –OnlineType Office365

      Nota

      Los valores válidos del parámetro DeploymentRegion son: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND y NorthAmerica2. Para el parámetro OnlineType, especifique Office365.

  3. Sus credenciales suministradas se validan al ejecutar el comando en el paso 2. Tras la ejecución correcta del comando, escriba el siguiente comando, y presione ENTRAR para mostrar las organizaciones a las que tiene acceso:

    $CRMOrgs

    Información de la organización de Dataverse.

Sugerencia

Puede usar la variable que se usó para almacenar las organizaciones de Dataverse recuperadas (en este caso, $CRMOrgs) con el cmdlet Get-CrmConnection para conectarse a Dataverse. Para especificar el nombre de la organización, utilice el siguiente comando: $CRMOrgs.UniqueName.

Si hay más de un valor de organización almacenado en la variable $CRMOrgs, puede referirse a la organización nth con el siguiente comando: $CRMOrgs[n-1]. Por ejemplo, para referirse al nombre único de la segunda organización de la variable $CRMOrgs, use el siguiente comando: $CRMOrgs[1].UniqueName.

Uso del cmdlet para conectarse a Dataverse

Use el cmdlet Get-CrmConnection para conectarse a una instancia de Dataverse. El cmdlet le permite usar el control común de inicio de sesión de los útiles de XRM para especificar sus credenciales y conectarse a Dataverse o especificar sus credenciales como parámetros en línea. Más información: Usar el control de inicio de sesión común de los útiles de XRM

Importante

Antes de usar el cmdlet Get-CrmConnection, asegúrese de que usa el siguiente comando de aplicar el uso de TLS 1.2 por PowerShell para conectarse a la instancia de Dataverse
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12
Más información acerca de los requisitos de TLS 1.2 para conexión de Dataverse Entrada de blog: Próximas actualizaciones de seguridad de conexión de Dataverse

Conexión a aplicaciones Dataverse mediante el control de inicio de sesión común

  1. Si desea usar el control de inicio de sesión común para proporcionar sus credenciales para conectarse a Dataverse, use el siguiente comando. La información de conexión se almacena en la variable $CRMConn para poder usarla más adelante.

    $CRMConn = Get-CrmConnection -InteractiveMode

  2. Se abre el cuadro de diálogo LoginControl. Especifique las credenciales para conectarse a la instancia de Dataverse y haga clic en Iniciar sesión.

Conexión a aplicaciones Dataverse especificando las credenciales en línea

  1. Para conectarse a Dataverse, use los comandos siguientes. Tenga en cuenta que estos comandos usan la variable $Cred que se creó anteriormente para almacenar las credenciales mientras se recuperaban las organizaciones. La información de conexión se guarda en la variable $CRMConn:

    • Si va a conectarse a una instancia de Dataverse

      $CRMConn = Get-CrmConnection -Credential $Cred -DeploymentRegion <Deployment region name> –OnlineType Office365 –OrganizationName <OrgName>

      Nota

      Los valores válidos para el parámetro DeploymentRegion son: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND y NorthAmerica2. Para el parámetro OnlineType, especifique Office365.

      Nota

      Para el parámetro OrganizationName de todos los comandos anteriores, puede especificar el nombre único o el nombre descriptivo de la organización. También puede usar el nombre único o el nombre descriptivo de la organización que recuperó mediante el cmdlet Get-CrmOrganizations y que almacenó en la variable $CRMOrgs. Por ejemplo, puede usar $CRMOrgs[x].UniqueName o $CRMOrgs[x].FriendlyName.

  2. Sus credenciales suministradas se validan al ejecutar el comando en el paso 1. Tras la ejecución correcta del cmdlet, escriba el siguiente comando, y presione ENTRAR para mostrar la información y el estado de conexión:

     $CRMConn

    Información y estado de la conexión de Dataverse.

Conectarse a Dataverse mediante OAuth

Las herramientas XRM utilizan internamente la autenticación OAuth al especificar el parámetro -InteractiveMode.

$CRMConn = Get-CrmConnection -InteractiveMode

La autenticación OAuth también se puede especificar cuando se usa una cadena de conexión donde AuthType=OAuth o AuthType=ClientSecret.

$CRMConn = Get-CrmConnection -ConnectionString "AuthType=ClientSecret;ClientId=..."

Más información: Usar cadenas de conexión en útiles de XRM para conectarse a Microsoft Dataverse

Consulte también

Use útiles de API XRM para conectarse a Dataverse
Crear aplicaciones cliente de Windows mediante las herramientas XRM
Blog: Módulo de PowerShell para realizar operaciones de datos y manipular la configuración de usuarios y del sistema en Dataverse

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).