Tipo de recurso cloudPcProvisioningPolicy

Artículo
09/25/2024

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.

Propiedades

Propiedad	Tipo	Descripción
alternateResourceUrl	Cadena	Dirección URL del recurso alternativo que se vincula a esta directiva de aprovisionamiento. Solo lectura.
autopatch	cloudPcProvisioningPolicyAutopatch	La configuración específica de Windows Autopatch que permite a sus clientes experimentarlo en pc en la nube. La configuración surte efecto cuando el inquilino se inscribe en Windows 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`.
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-m365`y `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` y `custom`. El valor predeterminado es `gallery`. Admite $filter, $select y $orderBy.
localAdminEnabled	Booleano	Cuando `true`es , 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` y `rpaBox`. El valor predeterminado es `windows365`. Use el encabezado de `Prefer: include-unknown-enum-members` solicitud para obtener el siguiente valor 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` Use el encabezado de `Prefer: include-unknown-enum-members` solicitud para obtener los siguientes valores de esta enumeración evolvable: `sharedByUser`, `sharedByEntraGroup`. 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 .
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`.
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.

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.

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",
  "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",
  "localAdminEnabled": "Boolean",
  "managedBy": "String",
  "microsoftManagedDesktop": {
    "@odata.type": "microsoft.graph.microsoftManagedDesktop"
  },
  "onPremisesConnectionId": "String",
  "provisioningType": "String",
  "windowsSetting": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSetting"
  },
  "windowsSettings": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSettings"
  }
}

Compartir a través de