Tipo de recurso cloudPcProvisioningPolicy

  • Artículo

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
Aprovisionamiento de listasDirectivas colección cloudPcProvisioningPolicy Enumera las propiedades y las relaciones de los objetos cloudPcProvisioningPolicy .
Obtener cloudPcProvisioningPolicy cloudPcProvisioningPolicy Lea las propiedades y relaciones de un objeto cloudPcProvisioningPolicy .
Creación de cloudPcProvisioningPolicy cloudPcProvisioningPolicy Cree un nuevo objeto cloudPcProvisioningPolicy .
Actualización de cloudPcProvisioningPolicy cloudPcProvisioningPolicy Actualice las propiedades de un objeto cloudPcProvisioningPolicy .
Eliminación de cloudPcProvisioningPolicy Ninguno Elimine un objeto cloudPcProvisioningPolicy .
Asignación de cloudPcProvisioningPolicy Ninguno Asigne una cloudPcProvisioningPolicy a grupos de usuarios.
Aplicar cloudPcProvisioningPolicy 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.
applyConfig 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.
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 se puede acceder al equipo 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. 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 y custom. El valor predeterminado es gallery. Admite $filter, $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 y rpaBox. El valor predeterminado es windows365. Tenga en cuenta que debe usar el encabezado de solicitud Prefer: include-unknown-enum-members para obtener el siguiente valor en esta enumeración activable: 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 licencia que se usa al aprovisionar equipos en la nube mediante esta directiva. De forma predeterminada, el tipo de licencia es si no se dedicated especifica provisioningType al crear cloudPcProvisioningPolicy. No se puede cambiar esta propiedad después de crear cloudPcProvisioningPolicy . Los valores posibles son: dedicated, shared y unknownFutureValue.
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 de que se unen a un dominio, elija una conexión con una red virtual validada por el servicio de PC en la nube. 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

Member Descripción
Dedicado Indica que se usa una licencia dedicada para aprovisionar equipos en la nube. Valor predeterminado.
compartido Indica que se usa una licencia compartida para aprovisionar equipos en la nube.
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",
  "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"
  }
}