Compartir a través de

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 equipos en la nube.

Métodos

Método Tipo devuelto Descripción
List colección cloudPcProvisioningPolicy Enumera las propiedades y las relaciones de los objetos cloudPcProvisioningPolicy .
Get cloudPcProvisioningPolicy Lea las propiedades y relaciones de un objeto cloudPcProvisioningPolicy .
Crear cloudPcProvisioningPolicy Cree un nuevo objeto cloudPcProvisioningPolicy .
Actualizar cloudPcProvisioningPolicy Actualice las propiedades de un objeto cloudPcProvisioningPolicy .
Delete Ninguno Elimine un objeto cloudPcProvisioningPolicy .
Assign Ninguno Asigne una cloudPcProvisioningPolicy a grupos de usuarios.
Apply Ninguno Aplique la configuración de directiva de aprovisionamiento actual a todos los dispositivos de PC en la nube en una directiva especificada. Actualmente, solo puede cambiar la región.
Aplicar configuración Ninguno Actualice la configuración de la directiva de aprovisionamiento para un conjunto de dispositivos de PC en la nube por sus identificadores.
Reintentar Ninguno Vuelva a intentar la operación de aprovisionamiento de equipos en la nube que usaron la directiva compartida de primera línea actual y no pudieron aplicar la directiva de aprovisionamiento.

Propiedades

Propiedad Tipo Description
alternateResourceUrl Cadena Dirección URL del recurso alternativo que se vincula a esta directiva de aprovisionamiento. Solo lectura.
Parche cloudPcProvisioningPolicyAutopatch Indica la configuración de Windows Autopatch para equipos en la nube mediante 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. Admite $select.
autopilotConfiguration cloudPcAutopilotConfiguration La configuración específica de Windows Autopilot que permite a los clientes Windows 365 experimentarlo en pc en la nube. Admite $select.
cloudPcGroupDisplayName Cadena Nombre para mostrar del grupo de pc en la nube en el que residen los pc en la nube. Solo lectura.
cloudPcNamingTemplate Cadena Plantilla que se usa para asignar un 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 equipo 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 Identificador único del usuario que creó esta directiva. Por ejemplo, 5ccb8d35-dd04-473e-a287-69bb4473208b. Solo lectura. Admite $select.
createdDateTime DateTimeOffset Marca de tiempo cuando se creó esta directiva de aprovisionamiento. 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, 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 Nombre para mostrar de la directiva de aprovisionamiento.
domainJoinConfigurations colección cloudPcDomainJoinConfiguration Especifica una lista ordenada por prioridad sobre cómo se unen los equipos en la nube Microsoft Entra ID (Azure AD). Admite $select.
enableSingleSignOn Booleano True si el inicio de sesión único puede acceder al equipo en la nube aprovisionado. False indica que el equipo en la nube aprovisionado no admite esta característica. El valor predeterminado es false. Windows 365 los usuarios 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 equipo 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 Nombre para mostrar de la imagen del sistema operativo que se usa para el aprovisionamiento. Por ejemplo, Windows 11 Preview + Microsoft 365 Apps 23H2 23H2. Admite $filter, $select y $orderBy.
imageId Cadena 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:
  • Editor: Microsoftwindowsdesktop
  • Ofrecer: 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-m365y 19h2-ent-cpc-os
Admite $filter, $select y $orderBy.
imageType 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: gallery, custom. El valor predeterminado es gallery. Admite $filter, $select y $orderBy.
lastModifiedBy Cadena Identificador único del usuario que actualizó por última vez esta directiva. Por ejemplo, 5ccb8d35-dd04-473e-a287-69bb4473208b. Solo lectura. Admite $select.
lastModifiedDateTime DateTimeOffset Marca de tiempo en la que se modificó por última vez esta directiva de aprovisionamiento. 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, 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 truees , el administrador local está habilitado para los equipos en la nube; false indica que el administrador local no está habilitado para los equipos 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 Prefer: include-unknown-enum-members solicitud para obtener los siguientes miembros en esta enumeración evolvable: rpaBox. Admite $filter, $select y $orderBy.
microsoftManagedDesktop microsoftManagedDesktop La configuración específica de microsoftManagedDesktop que permite a los clientes de Microsoft Managed Desktop obtener experiencia administrada por dispositivos para pc en la nube. Para permitir que microsoftManagedDesktop proporcione más valor, un administrador debe especificar cierta configuración en ella. Admite $filter, $select y $orderBy.
provisioningType cloudPcProvisioningType Especifica el tipo de licencias que se van a usar 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 evolvable: sharedByUser, sharedByEntraGroup, reserve. El shared miembro está en desuso y dejará de devolverse el 30 de abril de 2027; en adelante, use el sharedByUser miembro. Por ejemplo, un dedicated plan de servicio solo se puede asignar a un usuario y aprovisionar solo un equipo en la nube. Los shared planes y sharedByUser requieren que los clientes compren un plan de servicio compartido. Cada licencia compartida adquirida puede habilitar hasta tres equipos en la nube, con solo un usuario que haya iniciado sesión a la vez. El sharedByEntraGroup plan también requiere la compra de un plan de servicio compartido. Cada licencia compartida de este plan puede habilitar un equipo en la nube, que se comparte para el grupo según las asignaciones de esta directiva. De forma predeterminada, el tipo de licencia es si no se dedicated especifica provisioningType al crear cloudPcProvisioningPolicy. No puede cambiar esta propiedad después de crear cloudPcProvisioningPolicy .
userExperienceType cloudPcUserExperienceType Especifica el tipo de objeto en la nube al que el usuario final puede acceder. 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 en 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, provisioningType debe ser sharedByEntraGroup. Admite $filter, $select, $orderBy.
windowsSetting cloudPcWindowsSettings Indica una configuración específica de Windows que se va a configurar durante la creación de equipos en la nube para esta directiva de aprovisionamiento. Admite $select.
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 equipos en la nube de tipo sharedByEntraGroup. Admite $select.
domainJoinConfiguration (en desuso) cloudPcDomainJoinConfiguration Especifica cómo se unen los equipos en la nube 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 (en desuso) Cadena Identificador de cloudPcOnPremisesConnection. Para asegurarse de que los equipos en la nube tienen conectividad de red y que se unen a un dominio, elija una conexión con una red virtual que el servicio de PC en la nube la validó. La propiedad onPremisesConnectionId está 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 va a configurar durante la creación de equipos 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, use la propiedad windowsSetting .

valores cloudPcProvisioningType

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

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

valores cloudPcUserExperienceType

Member Descripción
cloudPc Indica que los usuarios finales pueden acceder a todo el escritorio.
Cloudapp Indica que los usuarios finales solo pueden acceder a cloud apps publicadas en esta directiva de aprovisionamiento.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.

Relaciones

Relación Tipo Descripción
assignments colección cloudPcProvisioningPolicyAssignment Colección definida de asignaciones de directivas de aprovisionamiento. Representa el conjunto de grupos y grupos de seguridad de Microsoft 365 en 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 Get 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",
  "userExperienceType": "String",
  "userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
  "windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
  "windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}
  • Last updated on