Windows 365 (versión preliminar)
Windows 365 es un servicio basado en la nube que crea de forma automática un nuevo tipo de máquina virtual con Windows (PC en la nube) para los usuarios finales. Cada PC en la nube se asigna a un usuario individual como un dispositivo Windows dedicado. Windows 365 proporciona las ventajas de productividad, seguridad y colaboración de Microsoft 365.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL | https://powerautomate.microsoft.com/en-us/support/ |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://www.microsoft.com/en-us/windows-365 |
| Directiva de privacidad | https://privacy.microsoft.com/en-us/privacystatement |
| Categorías | Operaciones de TI; Productividad |
El conector de Windows 365 proporciona acciones para administrar equipos en la nube de Windows 365 y directivas de aprovisionamiento dentro de su entorno de Microsoft Intune. Este conector le permite automatizar las operaciones del ciclo de vida de PC en la nube, la administración de directivas de aprovisionamiento y las tareas administrativas a través de flujos de Power Automate.
Servicio, clase y regiones
| Servicio | Clase | Regiones |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate |
| Aplicaciones lógicas | Premium | Todas las regiones de Logic Apps |
| Power Apps | Premium | Todas las regiones de Power Apps |
| Power Automate | Premium | Todas las regiones de Power Automate |
Contacto
| Contacto | |
|---|---|
| Nombre | Windows 365 |
| URL | https://learn.microsoft.com/en-us/connectors/windows365 |
| Correo Electrónico | W365powerplatform@microsoft.com |
Prerrequisitos
Para usar este conector, necesita lo siguiente:
- Licencias de Windows 365 para su organización
- Suscripción a Microsoft Intune
- Privilegios suficientes en el control de acceso basado en rol (RBAC) de Microsoft Intune para administrar recursos de Windows 365
- Cuenta de Azure AD con los permisos adecuados
Permisos necesarios
Los usuarios deben tener uno de los siguientes roles RBAC de Intune:
- Administrador global
- Administrador del servicio de Intune
- Administrador de Windows365 (para operaciones específicas de PC en la nube)
- Rol personalizado con permisos de Windows 365 (requiere
Webhook.CreateyWebhook.Deletepara las operaciones de desencadenador)
Importante: Este conector requiere licencias de Windows 365 y permisos de RBAC de Microsoft Intune adecuados. Todas las operaciones usan Microsoft Graph API y están sujetas a límites de Graph API.
Problemas y limitaciones conocidos
El conector de Windows 365 está actualmente en versión preliminar pública.
Microsoft quiere asegurarse de que un conector sea estable antes de lanzarlo para su disponibilidad general. Hasta ese momento, el conector está en versión preliminar. Las vistas previas se proporcionan "tal cual", "con todos los defectos" y "según disponibilidad". Están excluidos de los acuerdos de nivel de servicio (SLA), pero están disponibles en forma de vista previa para que pueda obtener acceso anticipado y proporcionar comentarios. Obtenga más información sobre las características en versión preliminar y cómo habilitarlas. Es posible que las versiones preliminares no estén cubiertas por el servicio de atención al cliente. Es posible que se suspendan en cualquier momento sin previo aviso y es posible que no se publiquen en disponibilidad general.
Le recomendamos que pruebe los conectores de versión preliminar y envíe sus comentarios. Esto nos ayudará a estabilizar y mejorar los conectores. Puede utilizar los foros de productos para compartir problemas y comentarios. Es posible que el soporte de Microsoft no esté disponible para las funciones de vista previa, incluidos los conectores, pero intentaremos ofrecer soporte en la medida de lo posible. Para más información, visite las preguntas más frecuentes sobre los conectores en versión preliminar.
Límites generales
- Las funcionalidades y limitaciones son coherentes con graph API subyacente.
- Cuando necesite llamar a algo en el punto de conexión beta de Graph, use la acción solicitud HTTP.
Acciones
Enumerar equipos en la nube
Identificador de la operación: ListCloudPCs
Esta acción le permite enumerar pc en la nube.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| $select | No | cuerda / cadena | $select permite elegir qué propiedades se devuelven de Graph. |
| $filtro | No | cuerda / cadena | $filter permite obtener un solo subconjunto de una colección de Graph. |
Devuelve
| Nombre | Tipo | Description |
|---|---|---|
| aadDeviceId | String | El identificador de dispositivo Microsoft Entra para el equipo en la nube, también conocido como identificador de dispositivo Azure Active Directory (Azure AD), que consta de 32 caracteres en un formato GUID. Se genera en una máquina virtual unida a Microsoft Entra ID. Solo lectura. |
| diskEncryptionState | String | Muestra el estado de cifrado de disco. |
| Nombre para mostrar | String | Nombre para mostrar del equipo en la nube. La longitud máxima es de 64 caracteres. Solo lectura. |
| gracePeriodEndDateTime | DateTimeOffset | Fecha y hora en que finaliza el período de gracia y se produce el reaprovisionamiento o desaprovisionamiento. Obligatorio solo si el estado es inGracePeriod. La marca de tiempo se muestra en formato ISO 8601 y hora universal coordinada (UTC). Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. |
| id | String | Identificador único de la entidad pc en la nube orientada al cliente que consta de 32 caracteres en un formato GUID. Solo lectura. |
| imageDisplayName | String | Nombre de la imagen del sistema operativo que se usa para el equipo en la nube. La longitud máxima es de 50 caracteres. Solo se permiten letras (A-Z, a-z), números (0-9) y caracteres especiales (-,_,.) para esta propiedad. El valor de la propiedad no puede comenzar ni terminar con un carácter de subrayado. Solo lectura. |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora de la última modificación del equipo en la nube. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z. |
| managedDeviceId | String | El Intune identificador de dispositivo inscrito para el equipo en la nube que consta de 32 caracteres en un formato GUID. La propiedad managedDeviceId de los equipos en la nube de Windows 365 Business siempre es null, ya que Windows 365 Business los equipos en la nube no se inscriben automáticamente Intune por Windows 365. Solo lectura. |
| managedDeviceName | String | El nombre del dispositivo Intune inscrito para el equipo en la nube. La propiedad managedDeviceName de equipos en la nube de Windows 365 Empresa siempre es nula, ya que windows 365 Empresa Cloud PC no están inscritos automáticamente por Intune en Windows 365. Solo lectura. |
| onPremisesConnectionName | String | La conexión local que se aplicó durante el aprovisionamiento de equipos en la nube. Solo lectura. |
| provisioningPolicyId | String | Identificador de directiva de aprovisionamiento para el equipo en la nube que consta de 32 caracteres en un formato GUID. Una directiva define el tipo de equipo en la nube que el usuario quiere crear. Solo lectura. |
| provisioningPolicyName | String | Directiva de aprovisionamiento que se aplicó durante el aprovisionamiento de equipos en la nube. La longitud máxima es de 120 caracteres. Solo lectura. |
| provisioningType | String | Muestra el tipo de aprovisionamiento. |
| servicePlanId | String | Identificador del plan de servicio para el equipo en la nube que consta de 32 caracteres en un formato GUID. Para obtener más información sobre los planes de servicio, consulte Nombres de producto e identificadores de plan de servicio para licencias. Solo lectura. |
| servicePlanName | String | Nombre del plan de servicio para la entidad de pc en la nube orientada al cliente. Solo lectura. |
| servicePlanType | String | Muestra el tipo de plan. |
| userPrincipalName | String | Nombre principal de usuario (UPN) del usuario asignado al equipo en la nube. La longitud máxima es de 113 caracteres. Para obtener más información sobre las directivas de nombre de usuario, consulte Directivas de contraseña y restricciones de cuentas en Microsoft Entra ID. Solo lectura. |
Obtención de directivas de aprovisionamiento
Identificador de la operación: GetProvisioningPoliciesV1
Esta acción permite devolver información sobre las directivas de aprovisionamiento.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| $select | No | String | $select permite elegir qué propiedades se devuelven de Graph. |
| $filtro | No | String | $filter permite obtener un solo subconjunto de una colección de Graph. |
| $expand | No | String | $expand permite devolver recursos relacionados desde Graph. |
Devuelve
Use $expand con un valor de asignaciones para ver los valores devueltos a continuación:
| Nombre | Tipo | Description |
|---|---|---|
| cloudPCNamingTemplate | String | Plantilla que se usa para asignar un nombre a los equipos en la nube aprovisionados mediante esta directiva. La plantilla puede contener tokens de texto y reemplazo personalizados, incluidos %USERNAME:x% y %RAND:x%, que representan el nombre del usuario y un número generado aleatoriamente, respectivamente. Por ejemplo, CPC-%USERNAME:4%-%RAND:5% significa que el nombre del PC en la nube comienza con CPC-, seguido de un nombre de usuario de cuatro caracteres, un carácter - y luego cinco caracteres aleatorios. La longitud total del texto generado por la plantilla no puede superar los 15 caracteres. |
| descripción | String | Descripción de la directiva de aprovisionamiento. |
| Nombre para mostrar | String | Nombre para mostrar de la directiva de aprovisionamiento. |
| domainJoinConfiguration | colección cloudPcDomainJoinConfiguration | Especifica una lista ordenada por prioridad sobre cómo se unen los equipos en la nube Microsoft Entra ID (Azure AD). |
| enableSingleSignOn | Boolean | True si se puede acceder al PC en la nube aprovisionado mediante el inicio de sesión único. False indica que el EQUIPO en la nube aprovisionado no admite esta característica. El valor predeterminado es false. Los usuarios de Windows 365 pueden usar el inicio de sesión único para autenticarse en microsoft Entra ID con opciones sin contraseña (por ejemplo, claves FIDO) para acceder a su PC en la nube |
| id | String | Identificador único asociado a la directiva de aprovisionamiento. Este identificador se rellena automáticamente durante la creación de una nueva directiva de aprovisionamiento. Solo lectura. |
| imageDisplayName | String | Nombre para mostrar de la imagen del sistema operativo que se usa para el aprovisionamiento. Por ejemplo, Windows 11 Preview + Aplicaciones de Microsoft 365 23H2 23H2. |
| imageId | String | Identificador único que representa una imagen de sistema operativo que se usa para aprovisionar nuevos equipos en la nube. El formato de una imagen de tipo galería es: {publisherName_offerName_skuName}. Los valores admitidos para cada uno de los parámetros son: publisher: Microsoftwindowsdesktop offer: windows-ent-cpc sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365 y 19h2-ent-cpc-os |
| tipoDeImagen | cloudPcProvisioningPolicyImageType | Tipo de imagen de sistema operativo (personalizada o galería) que se usa para el aprovisionamiento en equipos en la nube. Los valores posibles son: galería, personalizado. El valor predeterminado es gallery. |
Obtención de una directiva de aprovisionamiento
Identificador de la operación: GetAProvisioningPolicyV1
Esta acción le permite obtener los detalles de una directiva de aprovisionamiento específica.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| Identificador de directiva de aprovisionamiento | Sí | String | Identificador de la directiva de aprovisionamiento. Debe incluirse. |
| $select | No | String | $select permite elegir qué propiedades se devuelven de Graph. |
| $filtro | No | String | $filter permite obtener un solo subconjunto de una colección de Graph. |
Devuelve
Las salidas de esta operación son dinámicas.
Creación de una directiva de aprovisionamiento
Identificador de la operación: CreateAProvisioningPolicyV1
Esta acción permite crear una directiva de aprovisionamiento.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| Nombre | Sí | String | Directiva de aprovisionamiento que se aplicó durante el aprovisionamiento de equipos en la nube. La longitud máxima es de 120 caracteres |
| Description | Sí | String | Descripción de la directiva de aprovisionamiento. |
| Configuración de unión a un dominio | Sí | ||
| Id. de imagen | Sí | String | Este es el identificador de imagen que desea usar para el aprovisionamiento de pc en la nube. |
| Nombre para mostrar de la imagen | Sí | String | Nombre de la imagen del sistema operativo que se usa para el equipo en la nube. La longitud máxima es de 50 caracteres. Solo se permiten letras (A-Z, a-z), números (0-9) y caracteres especiales (-,_,.) para esta propiedad. El valor de la propiedad no puede comenzar ni terminar con un carácter de subrayado. |
| Tipo de imagen | Sí | String | Personalizado o galería. |
| Tipo de aprovisionamiento | Sí | String | Compartido o dedicado. |
| Configuración o configuración regional de Windows | Sí | String | Proporcione el idioma o la configuración regional que desea usar. Windows 365 proporciona más de 30 pares de idiomas o regiones. |
También puede agregar otros campos desde Graph en Parámetros avanzados.
Devuelve
Las salidas de esta operación son dinámicas.
Asignación de una directiva de aprovisionamiento a un grupo
Identificador de la operación: AssignAProvisioningPolicyToAGroupV1
Esta acción permite asignar un grupo a una directiva de aprovisionamiento.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| Identificador de directiva de aprovisionamiento | Sí | String | Este es el identificador de directiva de aprovisionamiento al que desea asignar un grupo. |
| Asignaciones: identificador de grupo de destino | Sí | String | Grupo de usuarios de Entra ID. |
| Asignaciones: id. de ServicePlan de destino | No | String | Identificador único del plan de servicio que indica el tamaño del PC en la nube que se va a aprovisionar para el usuario. |
Devuelve
Las salidas de esta operación son dinámicas.
Actualización de una directiva de aprovisionamiento
Identificador de la operación: UpdateAProvisioningPolicyV1
Esta acción permite actualizar una directiva de aprovisionamiento.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| Identificador de directiva de aprovisionamiento | Sí | String | Este es el identificador de directiva de aprovisionamiento de la directiva de aprovisionamiento que desea actualizar. |
| Description | No | String | Esta es la descripción de la directiva de aprovisionamiento a la que se actualizará. |
También puede agregar otros campos desde Graph en Parámetros avanzados.
Devuelve
Las salidas de esta operación son dinámicas.
Obtención de una directiva de aprovisionamiento
Identificador de la operación: GetAProvisoningPolicyV1
Esta acción permite obtener los detalles de una directiva de aprovisionamiento.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| Identificador de directiva de aprovisionamiento | Sí | String | Identificador de directiva de aprovisionamiento para el equipo en la nube que consta de 32 caracteres en un formato GUID. Una directiva define el tipo de equipo en la nube que el usuario quiere crear. |
| $select | No | String | $select permite elegir qué propiedades se devuelven de Graph. |
| $expand | No | String | $expand permite devolver recursos relacionados desde Graph. |
También puede agregar otros campos desde Graph en Parámetros avanzados.
Devuelve
Las salidas de esta operación son dinámicas.
Iniciar una acción remota
Identificador de la operación: RemoteActions
Esta acción le permite iniciar una acción remota en un EQUIPO en la nube.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| Id. de PC en la nube | Sí | String | Esto le permite especificar el identificador de PC en la nube al que desea dirigirse con una acción remota. |
| Acción remota | Sí | String | Esto le permite elegir cuándo quiere realizar una acción remota en un PC en la nube. |
| Acción remota: id. de instantánea | No | String | Si elige restaurar un PC en la nube, también debe proporcionar un identificador de instantánea. |
| Acción remota: nombre para mostrar | No | String | Si elige cambiar el nombre de un PC en la nube, también debe proporcionar un nombre para mostrar. |
Devuelve
Si se ejecuta correctamente, devuelve un código de respuesta 204 Sin contenido.
Envío de una solicitud HTTP de Microsoft Graph
Identificador de la operación: HttpRequest
Esta acción le permite llamar directamente a Graph y personalizar la llamada.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| URI | Sí | String | Esto le permite especificar qué URI se va a llamar, por ejemplo: https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents |
| Método | Sí | String | Esto le permite definir el método de llamada. |
También puede agregar otros campos (encabezados, cuerpo, etc.) en Parámetros avanzados.
Devuelve
Las salidas de esta operación son dinámicas.
Desencadenadores
Todos los escenarios forman parte de un desencadenador, que se puede seleccionar en el propio cuerpo del desencadenador.
| Nombre del desencadenador | Descripción |
|---|---|
| Cuando se desencadena una acción remota en un equipo en la nube | Permite desencadenar un flujo cuando se desencadena una acción remota. |
| Cuando se completa una acción remota en un equipo en la nube | Permite desencadenar un flujo cuando se completa una acción remota en un EQUIPO en la nube. |
| Cuando se actualiza una directiva de aprovisionamiento | Permite desencadenar un flujo cuando se actualiza una directiva de aprovisionamiento. |
| Cuando se crea una nueva directiva de aprovisionamiento | Permite iniciar un flujo cuando se crea una directiva de aprovisionamiento. |
| Cuando se crea un PC en la nube | Este desencadenador permite iniciar un flujo cuando se crea un PC en la nube. |
Cuando se actualiza una directiva de aprovisionamiento o pc en la nube
- Identificador de la operación: Webhook
- Descripción: Este desencadenador se desencadena cuando se actualiza una directiva de aprovisionamiento o pc en la nube.
Parámetros
| Nombre | Obligatorio | Tipo | Description |
|---|---|---|---|
| Scenario | Sí | Desplegable | Puede elegir entre los escenarios admitidos: |
| - Cuando se crea un PC en la nube | |||
| - Cuando se crea una nueva directiva de aprovisionamiento | |||
| - Cuando se actualiza una directiva de aprovisionamiento | |||
| - Cuando se completa una acción remota en un PC en la nube | |||
| - Cuando se desencadena una acción remota en un EQUIPO en la nube |
Devuelve
Las salidas de esta operación son dinámicas.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualización de una directiva de aprovisionamiento |
Actualiza una directiva de aprovisionamiento. |
| Asignación de una directiva de aprovisionamiento a un grupo |
Asigne una directiva de aprovisionamiento a un grupo. |
| Creación de una directiva de aprovisionamiento |
Crea una directiva de aprovisionamiento. |
| Eliminación de una directiva de aprovisionamiento |
Elimina una directiva de aprovisionamiento. |
| Enumerar equipos en la nube |
Enumerar cloudPCs |
| Envío de una solicitud HTTP de Microsoft Graph (versión preliminar) |
Construcción de una solicitud de API rest de Microsoft Graph |
| Iniciar una acción remota |
Inicie una acción remota en un PC en la nube. |
| Obtención de directivas de aprovisionamiento |
Obtiene una lista de directivas de aprovisionamiento. |
| Obtención de una directiva de aprovisionamiento |
Obtiene una directiva de aprovisionamiento específica. |
| Obtener un PC en la nube |
Obtiene un PC en la nube |
Actualización de una directiva de aprovisionamiento
Actualiza una directiva de aprovisionamiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de directiva de aprovisionamiento
|
id | True | string |
id |
|
Identificador de grupo
|
autopatchGroupId | string |
autopatchGroupId |
|
|
Id. del perfil de preparación del dispositivo
|
devicePreparationProfileId | string |
devicePreparationProfileId |
|
|
Tiempo de espera de la aplicación en minutos
|
applicationTimeoutInMinutes | integer |
applicationTimeoutInMinutes |
|
|
Si se ha denegado el acceso al dispositivo con errores
|
onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
|
Description
|
description | string |
descripción |
|
|
Nombre para mostrar
|
displayName | string |
Nombre para mostrar |
|
|
Tipo de combinación de dominio
|
domainJoinType | string |
domainJoinType |
|
|
Identificador de conexión local
|
onPremisesConnectionId | string |
onPremisesConnectionId |
|
|
Grupo de regiones
|
regionGroup | string |
regionGroup |
|
|
Nombre de la región
|
regionName | string |
regionName |
|
|
Tipo
|
type | string |
type |
|
|
Habilitación del inicio de sesión único
|
enableSingleSignOn | boolean |
enableSingleSignOn |
|
|
Nombre para mostrar de la imagen
|
imageDisplayName | string |
imageDisplayName |
|
|
Id. de imagen
|
imageId | string |
imageId |
|
|
Tipo de imagen
|
imageType | string |
tipoDeImagen |
|
|
Tipo administrado
|
managedType | string |
managedType |
|
|
Profile
|
profile | string |
profile |
|
|
Configuración regional
|
locale | string |
configuración regional |
|
|
Otros campos
|
otherFields | object |
Otros campos |
Asignación de una directiva de aprovisionamiento a un grupo
Asigne una directiva de aprovisionamiento a un grupo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de directiva de aprovisionamiento
|
id | True | string |
id |
|
Id. de directiva de aprovisionamiento
|
id | string |
Este es el identificador de directiva de aprovisionamiento al que desea asignar un grupo. |
|
|
Identificador de grupo
|
groupId | True | string |
groupId |
|
servicePlanId
|
servicePlanId | string |
Id. de ServicePlan de destino |
Creación de una directiva de aprovisionamiento
Crea una directiva de aprovisionamiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre
|
displayName | True | string |
Nombre para mostrar |
|
Description
|
description | True | string |
descripción |
|
domainJoinType
|
domainJoinType | string | ||
|
type
|
type | string | ||
|
regionName
|
regionName | string | ||
|
onPremisesConnectionId
|
onPremisesConnectionId | string | ||
|
regionGroup
|
regionGroup | string | ||
|
Otros campos
|
otherFields | object |
Otros campos |
|
|
Habilitar el inicio de sesión único
|
enableSingleSignOn | boolean |
enableSingleSignOn |
|
|
Id. de imagen
|
imageId | True | string |
imageId |
|
Nombre para mostrar de la imagen
|
imageDisplayName | True | string |
imageDisplayName |
|
Tipo de imagen
|
imageType | True | string |
tipoDeImagen |
|
Tipo de aprovisionamiento
|
provisioningType | True | string |
provisioningType |
|
Configuración regional
|
locale | True | string |
configuración regional |
|
Tipo administrado
|
managedType | string |
managedType |
|
|
Profile
|
profile | string |
profile |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
id |
|
Nombre para mostrar
|
displayName | string |
Nombre para mostrar de la directiva de aprovisionamiento. |
|
Description
|
description | string |
Descripción de la directiva de aprovisionamiento. |
|
Id. de imagen
|
imageId | string |
Identificador de la imagen del sistema operativo que desea aprovisionar en equipos en la nube. |
|
Nombre para mostrar de la imagen
|
imageDisplayName | string |
Nombre para mostrar de la imagen del sistema operativo que va a aprovisionar. |
|
Tipo de imagen
|
imageType | string |
Tipo de imagen del sistema operativo (personalizada o galería) que desea aprovisionar en equipos en la nube. |
|
Habilitar el inicio de sesión único
|
enableSingleSignOn | boolean |
Especifica si la directiva de aprovisionamiento ha habilitado el inicio de sesión único para pc en la nube. |
|
Plantilla de nomenclatura de PC en la nube
|
cloudPcNamingTemplate | string |
Plantilla que se usa para asignar un nombre a los equipos en la nube aprovisionados mediante esta directiva. |
|
Tipo de aprovisionamiento
|
provisioningType | string |
Especifica el tipo de licencia que se usa al aprovisionar equipos en la nube mediante esta directiva. |
|
managedBy
|
managedBy | string |
managedBy |
|
scopeIds
|
scopeIds | array of |
scopeIds |
|
Configuración de autopatch
|
autopatch | string |
Indica la configuración de Windows Autopatch para equipos en la nube mediante esta directiva de aprovisionamiento. |
|
autopilotConfiguration
|
autopilotConfiguration | string |
autopilotConfiguration |
|
domainJoinConfigurations
|
domainJoinConfigurations | array of object |
domainJoinConfigurations |
|
domainJoinType
|
domainJoinConfigurations.domainJoinType | string |
domainJoinType |
|
type
|
domainJoinConfigurations.type | string |
type |
|
regionName
|
domainJoinConfigurations.regionName | string |
regionName |
|
onPremisesConnectionId
|
domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
regionGroup
|
domainJoinConfigurations.regionGroup | string |
regionGroup |
|
managedType
|
microsoftManagedDesktop.managedType | string |
managedType |
|
type
|
microsoftManagedDesktop.type | string |
type |
|
profile
|
microsoftManagedDesktop.profile | string |
profile |
|
configuración regional
|
windowsSetting.locale | string |
configuración regional |
|
lenguaje
|
windowsSettings.language | string |
lenguaje |
Eliminación de una directiva de aprovisionamiento
Elimina una directiva de aprovisionamiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de directiva de aprovisionamiento
|
id | True | string |
id |
Enumerar equipos en la nube
Enumerar cloudPCs
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Seleccionar
|
$select | string |
Seleccione las propiedades que se van a devolver. |
|
|
Filter
|
$filter | string |
Por ejemplo, provisioningPolicyName eq 'XXX' y userPrincipalName eq 'XXX' |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador único de la entidad pc en la nube orientada al cliente que consta de 32 caracteres en un formato GUID. |
|
Id. de dispositivo Entra
|
aadDeviceId | string |
El identificador de dispositivo Microsoft Entra para el equipo en la nube, también conocido como identificador de dispositivo Azure Active Directory (Azure AD), que consta de 32 caracteres en un formato GUID. Se genera en una máquina virtual unida a Microsoft Entra ID. Solo lectura. |
|
Nombre para mostrar
|
displayName | string |
Nombre para mostrar del equipo en la nube. La longitud máxima es de 64 caracteres. Solo lectura. |
|
Nombre para mostrar de la imagen
|
imageDisplayName | string |
Nombre de la imagen del sistema operativo que se usa para el equipo en la nube. La longitud máxima es de 50 caracteres. |
|
Identificador de directiva de aprovisionamiento
|
provisioningPolicyId | string |
Identificador de directiva de aprovisionamiento para el equipo en la nube que consta de 32 caracteres en un formato GUID. Una directiva define el tipo de equipo en la nube que el usuario quiere crear. |
|
Nombre de la directiva de aprovisionamiento
|
provisioningPolicyName | string |
Directiva de aprovisionamiento que se aplicó durante el aprovisionamiento de equipos en la nube. |
|
Nombre de conexión local
|
onPremisesConnectionName | string |
Conexión de red de Azure que se aplicó durante el aprovisionamiento de equipos en la nube. |
|
Identificador del plan de servicio
|
servicePlanId | string |
Identificador del plan de servicio para el equipo en la nube que consta de 32 caracteres en un formato GUID. |
|
Nombre del plan de servicio
|
servicePlanName | string |
El nombre del plan de servicio para la entidad pc en la nube de acing del cliente. |
|
estado
|
status | string |
estado |
|
Nombre principal de usuario
|
userPrincipalName | string |
Nombre principal de usuario (UPN) del usuario asignado al equipo en la nube. |
|
Fecha y hora de última modificación
|
lastModifiedDateTime | string |
Fecha y hora de la última modificación del equipo en la nube. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. |
|
Identificador de dispositivo administrado
|
managedDeviceId | string |
El Intune identificador de dispositivo inscrito para el equipo en la nube que consta de 32 caracteres en un formato GUID. |
|
Nombre del dispositivo administrado
|
managedDeviceName | string |
El nombre del dispositivo Intune inscrito para el equipo en la nube. |
|
Fecha y hora de finalización del período de gracia
|
gracePeriodEndDateTime | string |
Fecha y hora en que finaliza el período de gracia y se produce el reaprovisionamiento o desaprovisionamiento. |
|
Estado de cifrado de disco
|
diskEncryptionState | string |
Estado de cifrado de disco |
|
Tipo de aprovisionamiento
|
provisioningType | string |
Tipo de licencias que se van a usar al aprovisionar equipos en la nube mediante esta directiva. |
|
Nombre para mostrar de asignación
|
allotmentDisplayName | string |
Nombre para mostrar de asignación |
|
Detalles de estado
|
statusDetail | string |
Detalles de estado |
|
Habilitar el inicio de sesión único
|
connectionSetting.enableSingleSignOn | boolean |
Especifica si la directiva de aprovisionamiento ha habilitado el inicio de sesión único para pc en la nube. |
|
partnerAgentInstallResults
|
partnerAgentInstallResults | array of string |
partnerAgentInstallResults |
Envío de una solicitud HTTP de Microsoft Graph (versión preliminar)
Construcción de una solicitud de API rest de Microsoft Graph
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
URI completo o relativo. Ejemplo: |
|
Método
|
Method | True | string |
El método HTTP (el valor predeterminado es GET) |
|
Body
|
Body | binary |
Contenido del cuerpo de la solicitud |
|
|
Tipo de contenido
|
ContentType | string |
Encabezado content-type para el cuerpo (el valor predeterminado es application/json) |
|
|
CustomHeader1
|
CustomHeader1 | string |
Encabezado personalizado 1. Especifique en formato: header-name: header-value |
|
|
CustomHeader2
|
CustomHeader2 | string |
Encabezado personalizado 2. Especifique en formato: header-name: header-value |
|
|
CustomHeader3
|
CustomHeader3 | string |
Encabezado personalizado 3. Especifique en formato: header-name: header-value |
|
|
CustomHeader4
|
CustomHeader4 | string |
Encabezado personalizado 4. Especifique en formato: header-name: header-value |
|
|
CustomHeader5
|
CustomHeader5 | string |
Encabezado personalizado 5. Especifique en formato: header-name: header-value |
Devoluciones
- response
- ObjectWithoutType
Iniciar una acción remota
Inicie una acción remota en un PC en la nube.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de PC en la nube
|
cloudPcId | True | string |
Identificador único del equipo en la nube. |
|
Acción remota
|
remoteAction | True | string |
Acción remota que se va a realizar en el PC en la nube. |
|
Id. de instantánea de PC en la nube
|
cloudPcSnapshotId | string |
Necesario para la restauración |
|
|
Nombre para mostrar
|
displayName | string |
Necesario para cambiar el nombre |
Obtención de directivas de aprovisionamiento
Obtiene una lista de directivas de aprovisionamiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Seleccionar
|
$select | string |
Devuelve las propiedades predeterminadas si no se especifica; la primera opción devuelve todas las propiedades. |
|
|
Filter
|
$filter | string |
Filtrar elementos por valores de propiedad. |
|
|
Expandir
|
$expand | string |
Expande las entidades relacionadas en línea. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of object |
value |
|
assignments
|
value.assignments | array of object | |
|
items
|
value.assignments | object | |
|
Description
|
value.description | string |
Descripción de la directiva de aprovisionamiento. |
|
Nombre para mostrar
|
value.displayName | string |
Nombre para mostrar de la directiva de aprovisionamiento. |
|
Configuraciones de unión a un dominio
|
value.domainJoinConfigurations | array of object |
Especifica una lista ordenada por prioridad sobre cómo se unen los equipos en la nube Microsoft Entra ID. |
|
onPremisesConnectionId
|
value.domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
type
|
value.domainJoinConfigurations.type | string |
type |
|
managedType
|
value.microsoftManagedDesktop.managedType | string |
managedType |
|
profile
|
value.microsoftManagedDesktop.profile | string |
profile |
|
autopatchGroupId
|
value.autopatch.autopatchGroupId | string |
autopatchGroupId |
|
devicePreparationProfileId
|
value.autopilotConfiguration.devicePreparationProfileId | string |
devicePreparationProfileId |
|
applicationTimeoutInMinutes
|
value.autopilotConfiguration.applicationTimeoutInMinutes | integer |
applicationTimeoutInMinutes |
|
onFailureDeviceAccessDenied
|
value.autopilotConfiguration.onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
Habilitar el inicio de sesión único
|
value.enableSingleSignOn | boolean |
Especifica si la directiva de aprovisionamiento ha habilitado el inicio de sesión único para pc en la nube. |
|
Id
|
value.id | string |
id |
|
Nombre para mostrar de la imagen
|
value.imageDisplayName | string |
Nombre para mostrar de la imagen del sistema operativo que va a aprovisionar. |
|
Id. de imagen
|
value.imageId | string |
Identificador de la imagen del sistema operativo que desea aprovisionar en equipos en la nube. |
|
Tipo de imagen
|
value.imageType | string |
Tipo de imagen del sistema operativo (personalizada o galería) que desea aprovisionar en equipos en la nube. |
|
configuración regional
|
value.windowsSetting.locale | string |
configuración regional |
|
managedBy
|
value.managedBy | string |
managedBy |
|
Tipo de aprovisionamiento
|
value.provisioningType | string |
Especifica el tipo de licencia que se usa al aprovisionar equipos en la nube mediante esta directiva. |
Obtención de una directiva de aprovisionamiento
Obtiene una directiva de aprovisionamiento específica.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de directiva de aprovisionamiento
|
id | True | string |
id |
|
Seleccionar
|
$select | string |
Devuelve las propiedades predeterminadas si no se especifica; la primera opción devuelve todas las propiedades. |
|
|
Expandir
|
$expand | string |
Expande las entidades relacionadas en línea. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
assignments
|
assignments | array of object | |
|
items
|
assignments | object | |
|
Description
|
description | string |
Descripción de la directiva de aprovisionamiento. |
|
Nombre para mostrar
|
displayName | string |
Nombre para mostrar de la directiva de aprovisionamiento. |
|
Configuraciones de unión a un dominio
|
domainJoinConfigurations | array of object |
Especifica una lista ordenada por prioridad sobre cómo se unen los equipos en la nube Microsoft Entra ID. |
|
onPremisesConnectionId
|
domainJoinConfigurations.onPremisesConnectionId | string |
onPremisesConnectionId |
|
type
|
domainJoinConfigurations.type | string |
type |
|
managedType
|
microsoftManagedDesktop.managedType | string |
managedType |
|
profile
|
microsoftManagedDesktop.profile | string |
profile |
|
autopatchGroupId
|
autopatch.autopatchGroupId | string |
autopatchGroupId |
|
devicePreparationProfileId
|
autopilotConfiguration.devicePreparationProfileId | string |
devicePreparationProfileId |
|
applicationTimeoutInMinutes
|
autopilotConfiguration.applicationTimeoutInMinutes | integer |
applicationTimeoutInMinutes |
|
onFailureDeviceAccessDenied
|
autopilotConfiguration.onFailureDeviceAccessDenied | boolean |
onFailureDeviceAccessDenied |
|
Habilitar el inicio de sesión único
|
enableSingleSignOn | boolean |
Especifica si la directiva de aprovisionamiento ha habilitado el inicio de sesión único para pc en la nube. |
|
Id
|
id | string |
id |
|
Nombre para mostrar de la imagen
|
imageDisplayName | string |
Nombre para mostrar de la imagen del sistema operativo que va a aprovisionar. |
|
Id. de imagen
|
imageId | string |
Identificador de la imagen del sistema operativo que desea aprovisionar en equipos en la nube. |
|
Tipo de imagen
|
imageType | string |
Tipo de imagen del sistema operativo (personalizada o galería) que desea aprovisionar en equipos en la nube. |
|
configuración regional
|
windowsSetting.locale | string |
configuración regional |
|
managedBy
|
managedBy | string |
managedBy |
|
Tipo de aprovisionamiento
|
provisioningType | string |
Especifica el tipo de licencia que se usa al aprovisionar equipos en la nube mediante esta directiva. |
Obtener un PC en la nube
Obtiene un PC en la nube
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de PC en la nube
|
cloudPcId | True | string |
Identificador único del equipo en la nube. |
|
Seleccionar
|
$select | string |
Seleccione las propiedades que se van a devolver. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador único de la entidad pc en la nube orientada al cliente que consta de 32 caracteres en un formato GUID. |
|
Id. de dispositivo Entra
|
aadDeviceId | string |
El identificador de dispositivo Microsoft Entra para el equipo en la nube, también conocido como identificador de dispositivo Azure Active Directory (Azure AD), que consta de 32 caracteres en un formato GUID. Se genera en una máquina virtual unida a Microsoft Entra ID. Solo lectura. |
|
Nombre para mostrar
|
displayName | string |
Nombre para mostrar del equipo en la nube. La longitud máxima es de 64 caracteres. Solo lectura. |
|
Nombre para mostrar de la imagen
|
imageDisplayName | string |
Nombre de la imagen del sistema operativo que se usa para el equipo en la nube. La longitud máxima es de 50 caracteres. |
|
Identificador de directiva de aprovisionamiento
|
provisioningPolicyId | string |
Identificador de directiva de aprovisionamiento para el equipo en la nube que consta de 32 caracteres en un formato GUID. Una directiva define el tipo de equipo en la nube que el usuario quiere crear. |
|
Nombre de la directiva de aprovisionamiento
|
provisioningPolicyName | string |
Directiva de aprovisionamiento que se aplicó durante el aprovisionamiento de equipos en la nube. |
|
Nombre de conexión local
|
onPremisesConnectionName | string |
Conexión de red de Azure que se aplicó durante el aprovisionamiento de equipos en la nube. |
|
Identificador del plan de servicio
|
servicePlanId | string |
Identificador del plan de servicio para el equipo en la nube que consta de 32 caracteres en un formato GUID. |
|
Nombre del plan de servicio
|
servicePlanName | string |
El nombre del plan de servicio para la entidad pc en la nube de acing del cliente. |
|
estado
|
status | string |
estado |
|
Nombre principal de usuario
|
userPrincipalName | string |
Nombre principal de usuario (UPN) del usuario asignado al equipo en la nube. |
|
Fecha y hora de última modificación
|
lastModifiedDateTime | string |
Fecha y hora de la última modificación del equipo en la nube. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. |
|
Identificador de dispositivo administrado
|
managedDeviceId | string |
El Intune identificador de dispositivo inscrito para el equipo en la nube que consta de 32 caracteres en un formato GUID. |
|
Nombre del dispositivo administrado
|
managedDeviceName | string |
El nombre del dispositivo Intune inscrito para el equipo en la nube. |
|
Fecha y hora de finalización del período de gracia
|
gracePeriodEndDateTime | string |
Fecha y hora en que finaliza el período de gracia y se produce el reaprovisionamiento o desaprovisionamiento. |
|
Estado de cifrado de disco
|
diskEncryptionState | string |
Estado de cifrado de disco |
|
Tipo de aprovisionamiento
|
provisioningType | string |
Tipo de licencias que se van a usar al aprovisionar equipos en la nube mediante esta directiva. |
|
Nombre para mostrar de asignación
|
allotmentDisplayName | string |
Nombre para mostrar de asignación |
|
Detalles de estado
|
statusDetail | string |
Detalles de estado |
|
Habilitar el inicio de sesión único
|
connectionSetting.enableSingleSignOn | boolean |
Habilitar el inicio de sesión único |
|
partnerAgentInstallResults
|
partnerAgentInstallResults | array of string |
partnerAgentInstallResults |
Desencadenadores
| Cuando se actualiza una directiva de aprovisionamiento o pc en la nube |
Cuando se actualiza una directiva de aprovisionamiento o pc en la nube |
Cuando se actualiza una directiva de aprovisionamiento o pc en la nube
Cuando se actualiza una directiva de aprovisionamiento o pc en la nube
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
escenario
|
scenario | True | string |
escenario |