tipo de recurso cloudPcProvisioningPolicy

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una directiva de aprovisionamiento de PC en la nube.

Métodos

Método	Tipo devuelto	Descripción
List	Recopilación cloudPcProvisioningPolicy	Enumerar las propiedades y las relaciones de los objetos cloudPcProvisioningPolicy .
Get	cloudPcProvisioningPolicy	Lea las propiedades y las relaciones de un objeto cloudPcProvisioningPolicy .
Crear	cloudPcProvisioningPolicy	Cree un nuevo objeto cloudPcProvisioningPolicy .
Actualizar	cloudPcProvisioningPolicy	Actualice las propiedades de un objeto cloudPcProvisioningPolicy .
Delete	Ninguno	Eliminar un objeto cloudPcProvisioningPolicy .
Assign	Ninguno	Asignar una cloudPcProvisioningPolicy a los grupos de usuarios.
Apply	Ninguno	Aplique la configuración actual de directiva de aprovisionamiento a todos los dispositivos de PC en la nube de una directiva especificada.
Aplicar configuración	Ninguno	Actualice la configuración de la directiva de aprovisionamiento de un conjunto de dispositivos PC en la nube por sus identificadores.
Reintentar	Ninguno	Vuelva a intentar la operación de aprovisionamiento para los PC en la nube que usaron la directiva compartida de primera línea actual y no pudieron aplicar la directiva de aprovisionamiento.
Programar la tarea de aplicar directiva	Ninguno	Programar una tarea de aplicación de directiva para una directiva de aprovisionamiento.
Recuperar el resultado de la acción de aplicación de directiva	cloudPcPolicyApplyActionResult	Recuperar el resultado de una acción de aplicación de directiva para una directiva de aprovisionamiento.
Recuperar la programación de aplicación de la directiva	cloudPcPolicyScheduledApplyActionDetail	Recuperar la programación de una acción de aplicación de directivas para una directiva de aprovisionamiento.
Recuperar el resultado del estado de actualización de la directiva	cloudPcPolicyPendingApplyStatusResult	Recupere el estado de aplicación pendiente de una directiva de aprovisionamiento para determinar si existen cambios sin aplicar para los PC en la nube.

Propiedades

Propiedad	Tipo	Descripción
alternateResourceUrl	Cadena	La dirección URL del recurso alternativo que está vinculado a esta directiva de aprovisionamiento. Solo lectura.
autopatch	cloudPcProvisioningPolicyAutopatch	Indica la configuración de Windows Autopatch para los PC en la nube que usan esta directiva de aprovisionamiento. La configuración surte efecto cuando el inquilino se inscribe en Autopatch y el managedType de la propiedad microsoftManagedDesktop se establece como `starterManaged`. Al crear o actualizar una directiva de aprovisionamiento con autopatch, debe usar un token delegado y el usuario que ha iniciado sesión debe tener el rol Administrador de Intune. Admite `$select`.
autopilotConfiguration	cloudPcAutopilotConfiguration	La configuración específica de Windows Autopilot que permite a los clientes de Windows 365 experimentarlo en PC en la nube. Al crear o actualizar una directiva de aprovisionamiento con autopilotConfiguration, usa los permisos necesarios de Microsoft Graph que se enumeran en las páginas correspondientes de crear y actualizar API. En escenarios delegados, el usuario que ha iniciado sesión también debe tener el permiso RBAC de `Microsoft.Intune/DeviceConfigurations/Assign` Intune. Admite `$select`.
cloudPcGroupDisplayName	Cadena	El nombre para mostrar del grupo de PC en la nube en el que residen los PC en la nube. Solo lectura.
cloudPcNamingTemplate	Cadena	La plantilla usada para dar nombre a los equipos en la nube aprovisionados mediante esta directiva. La plantilla puede contener texto personalizado y tokens de reemplazo, 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 por `CPC-`, seguido de un nombre de usuario de cuatro caracteres, un `-` carácter y, a continuación, cinco caracteres aleatorios. La longitud total del texto generado por la plantilla no puede superar los 15 caracteres. Admite `$filter`, `$select` y `$orderby`.
createdBy	String	El identificador único del usuario que creó esta directiva. Por ejemplo, `5ccb8d35-dd04-473e-a287-69bb4473208b`. Solo lectura. Admite `$select`.
createdDateTime	DateTimeOffset	La marca de tiempo en que se creó esta directiva de aprovisionamiento. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería `2014-01-01T00:00:00Z`. Solo lectura. Admite `$select` y `$orderBy`.
description	Cadena	Descripción de la directiva de aprovisionamiento. Admite `$filter`, `$select` y `$orderBy`.
displayName	Cadena	El nombre para mostrar de la directiva de aprovisionamiento.
domainJoinConfigurations	Colección cloudPcDomainJoinConfiguration	Especifica una lista ordenada por prioridad sobre cómo los PC en la nube se unen a Microsoft Entra ID (Azure AD). Admite `$select`.
enableSingleSignOn	Booleano	`True` si es de inicio de sesión único puede acceder al PC en la nube aprovisionado. `False` indica que el PC 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. Opcional.
gracePeriodInHours	Int32	Número de horas de espera antes de que se produzca el reaprovisionamiento o desaprovisionamiento. Solo lectura.
id	Cadena	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. Admite `$filter`, `$select` y `$orderBy`.
imageDisplayName	Cadena	El nombre para mostrar de la imagen del sistema operativo que se usa para el aprovisionamiento. Por ejemplo, `Windows 11 Preview + Aplicaciones Microsoft 365 23H2 23H2`. Admite `$filter`, `$select` y `$orderBy`.
identificador de imagen	Cadena	El identificador único que representa una imagen del sistema operativo que se usa para aprovisionar nuevos PC 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: Editorial: `Microsoftwindowsdesktop` Oferta: `windows-ent-cpc` SKU: `21h1-ent-cpc-m365`, `21h1-ent-cpc-os`, `20h2-ent-cpc-m365`, `20h2-ent-cpc-os`, `20h1-ent-cpc-m36520h1-ent-cpc-os19h2-ent-cpc-m365`y`19h2-ent-cpc-os` Admite `$filter`, `$select` y `$orderBy`.
tipo de imagen	cloudPcProvisioningPolicyImageType	El tipo de imagen del sistema operativo (personalizada o de galería) que se usa para el aprovisionamiento en equipos en la nube. Los valores posibles son: `gallery`, `custom`. El valor predeterminado es `gallery`. Admite $filter, $select y $orderBy.
lastModifiedBy	Cadena	El identificador único del usuario que actualizó por última vez esta directiva. Por ejemplo, `5ccb8d35-dd04-473e-a287-69bb4473208b`. Solo lectura. Admite `$select`.
lastModifiedDateTime	DateTimeOffset	La marca de tiempo en que se modificó por última vez esta directiva de aprovisionamiento. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería `2014-01-01T00:00:00Z`. Solo lectura. Admite `$select` y `$orderBy`.
localAdminEnabled	Booleano	Cuando `true`, el administrador local está habilitado para PC en la nube; `false` indica que el administrador local no está habilitado para PC en la nube. El valor predeterminado es `false`. Admite `$filter`, `$select` y `$orderBy`.
managedBy	cloudPcManagementService	Indica el servicio que administra la directiva de aprovisionamiento. Los valores posibles son: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox`, `microsoft365Opal`, `microsoft365BizChat`. El valor predeterminado es `windows365`. Use el encabezado de solicitud `Prefer: include-unknown-enum-members` para obtener los siguientes miembros en esta enumeración evolutiva: `rpaBox`. Admite `$filter`, `$select` y `$orderBy`.
microsoftManagedDesktop	microsoftManagedDesktop	La configuración específica de microsoftManagedDesktop que permite a los clientes de Escritorio administrado de Microsoft obtener la experiencia administrada del dispositivo para PC en la nube. Para permitir que microsoftManagedDesktop proporcione más valor, un administrador debe especificar determinadas opciones de configuración. Admite `$filter`, `$select` y `$orderBy`.
provisioningType	cloudPcProvisioningType	Especifica el tipo de licencias que se usarán al aprovisionar equipos en la nube mediante esta directiva. Los valores posibles son `dedicated`, `shared`, `unknownFutureValue`, `sharedByUser`, `sharedByEntraGroup`, `reserve`, . Use el encabezado de `Prefer: include-unknown-enum-members` solicitud para obtener los siguientes valores de esta enumeración evolutiva: `sharedByUser`, , `reservesharedByEntraGroup`. El `shared` miembro está en desuso y dejará de volver el 30 de abril de 2027; en el futuro, usa el `sharedByUser` miembro. Por ejemplo, se puede asignar un `dedicated` plan de servicio a un solo usuario y aprovisionar solo a un PC en la nube. Los `shared` planes y `sharedByUser` requieren que los clientes compren un plan de servicio compartido. Cada licencia compartida comprada puede habilitar hasta tres PC en la nube, con solo un usuario conectado a la vez. El `sharedByEntraGroup` plan también requiere la compra de un plan de servicio compartido. Cada licencia compartida bajo este plan puede habilitar un PC en la nube, que se comparte para el grupo de acuerdo con las asignaciones de esta directiva. De forma predeterminada, el tipo de licencia es `dedicated` si el tipo de aprovisionamiento no se especifica al crear la cloudPcProvisioningPolicy. No se puede cambiar esta propiedad después de crear cloudPcProvisioningPolicy .
scopeIds	Colección string	La lista de identificadores de etiquetas de ámbito para este recurso. Solo lectura.
snapshotResetMode	cloudPcSnapshotResetMode	Indica si está disponible el restablecimiento de instantáneas para esta directiva de aprovisionamiento. Los valores posibles son: `notApplicable`, `enabled`, `disabled` y `unknownFutureValue` El valor predeterminado es `notApplicable`.
userExperienceType	cloudPcUserExperienceType	Especifica el tipo de objeto de nube al que puede tener acceso el usuario final. Los valores posibles son: `cloudPc`, `cloudApp`, `unknownFutureValue`. `cloudPc` Indica que el usuario final puede acceder a todo el escritorio. `cloudApp` Indica que el usuario final solo puede acceder a las aplicaciones publicadas bajo esta directiva de aprovisionamiento. El tipo no se puede cambiar una vez creada la directiva de aprovisionamiento. Si no se especifica durante la creación, el valor predeterminado es `cloudPc`. Cuando `cloudApp` se selecciona, el tipo de aprovisionamiento debe ser `sharedByEntraGroup`. Admite `$filter`, `$select`, `$orderBy`.
userSettingsPersistenceConfiguration	cloudPcUserSettingsPersistenceConfiguration	Indica una configuración específica que habilita la persistencia de la configuración de la aplicación de usuario entre sesiones de PC en la nube. El valor predeterminado es `null`. Esta característica solo está disponible para las directivas de aprovisionamiento de PC en la nube de tipo .`sharedByEntraGroup` Admite `$select`.
windowsSetting	cloudPcWindowsSettings	Indica una configuración específica de Windows que se debe configurar durante la creación de equipos en la nube para esta directiva de aprovisionamiento. Admite `$select`.
domainJoinConfiguration (obsoleto)	cloudPcDomainJoinConfiguration	Especifica cómo los PC en la nube se unen a Microsoft Entra ID. La propiedad domainJoinConfiguration está en desuso y dejará de devolver datos el 31 de mayo de 2024. En el futuro, use la propiedad domainJoinConfigurations .
onPremisesConnectionId (obsoleto)	Cadena	El id. de cloudPcOnPremisesConnection. Para asegurarse de que los PC en la nube tienen conectividad de red y se unen a un dominio, elija una conexión con una red virtual que el servicio de PC en la nube haya validado. La propiedad onPremisesConnectionId quedará en desuso y dejará de devolver datos el 31 de mayo de 2024. En el futuro, use la propiedad domainJoinConfigurations .
windowsSettings (en desuso)	cloudPcWindowsSettings	Configuración específica de Windows que se debe configurar durante la creación de PC en la nube para esta directiva de aprovisionamiento. Admite `$select`. La propiedad windowsSettings está en desuso y dejará de devolver datos el 31 de enero de 2024. En el futuro, usa la propiedad windowsSetting .

valores de cloudPcProvisioningType

En la tabla siguiente se enumeran los miembros de una enumeración evolutiva. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolutiva: sharedByUser, sharedByEntraGroup, reserve.

Member	Descripción
dedicado	Indica que se usa una licencia dedicada para aprovisionar PC en la nube. Valor predeterminado.
Compartido (en desuso)	Indica que se usa una licencia compartida para aprovisionar PC en la nube. El `shared` miembro está en desuso y dejará de volver el 30 de abril de 2027. En el futuro, use el `sharedByUser` miembro.
unknownFutureValue	Valor centinela de enumeración evolutiva. No usar.
sharedByUser	Indica la directiva de aprovisionamiento cuando se aprovisiona un PC en la nube dedicado para cada usuario del grupo de asignación. Los usuarios siempre están conectados al mismo PC en la nube. Sin embargo, la disponibilidad del PC en la nube está limitada por el número total de sesiones activas.
sharedByEntraGroup	Indica la directiva de aprovisionamiento asociada a los PC en la nube compartidos por un grupo de Microsoft Entra (Azure AD). Cuando se aprovisiona un PC en la nube compartido, estará disponible para que cualquier usuario del grupo de asignación de Microsoft Entra ID se conecte a él. Los usuarios se pueden conectar a un PC en la nube diferente en cada conexión y la disponibilidad está limitada por el número de PC en la nube aprovisionados.
reservar	Indica que la directiva debe usar licencias dedicadas, por usuario y con límite de tiempo cuando se aprovisionan equipos en la nube. El usuario puede extraer y proteger estos PC en la nube que usan la directiva de reserva varias veces, y la licencia con límite de tiempo solo se consume después de extraer el PC en la nube. Actualmente, cada usuario puede obtener 10 horas de tiempo de uso de cada instancia del plan de servicio de reserva.

valores de cloudPcSnapshotResetMode

Member	Descripción
no aplicable	Indica que el restablecimiento de instantáneas no es aplicable a la directiva de aprovisionamiento.
habilitado	Indica que el restablecimiento de instantáneas está habilitado para la directiva de aprovisionamiento.
deshabilitado	Indica que el restablecimiento de instantáneas está deshabilitado para la directiva de aprovisionamiento.
unknownFutureValue	Valor centinela de enumeración evolutiva. No usar.

valores de cloudPcUserExperienceType

Member	Descripción
cloudPc	Indica que los usuarios finales pueden acceder a todo el escritorio.
aplicación de nube	Indica que los usuarios finales solo pueden acceder a las aplicaciones en la nube publicadas bajo esta directiva de aprovisionamiento.
unknownFutureValue	Valor centinela de enumeración evolutiva. No usar.

Relaciones

Relación	Tipo	Descripción
assignments	colección cloudPcProvisioningPolicyAssignment	Una colección definida de asignaciones de directivas de aprovisionamiento. Representa el conjunto de grupos de Microsoft 365 y grupos de seguridad de Microsoft Entra ID que tienen asignada la directiva de aprovisionamiento. Solo se devuelve en `$expand`. Para obtener un ejemplo sobre cómo obtener la relación de asignaciones, consulte Obtener cloudPcProvisioningPolicy.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "alternateResourceUrl": "String",
  "autopatch": {"@odata.type": "microsoft.graph.cloudPcProvisioningPolicyAutopatch"},
  "autopilotConfiguration": {"@odata.type": "microsoft.graph.cloudPcAutopilotConfiguration"},
  "cloudPcGroupDisplayName": "String",
  "cloudPcNamingTemplate": "String",
  "createdBy": "String",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "domainJoinConfiguration": {"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"},
  "domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
  "enableSingleSignOn": "Boolean",
  "gracePeriodInHours": "Int32",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "imageId": "String",
  "imageType": "String",
  "lastModifiedBy": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "localAdminEnabled": "Boolean",
  "managedBy": "String",
  "microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
  "onPremisesConnectionId": "String",
  "provisioningType": "String",
  "scopeIds": ["String"],
  "snapshotResetMode": "String",
  "userExperienceType": "String",
  "userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
  "windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
  "windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-08-19