Actualizar 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.

Actualice las propiedades de un objeto cloudPcProvisioningPolicy .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) CloudPC. ReadWrite. All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación CloudPC. ReadWrite. All No disponible.

Solicitud HTTP

PATCH /deviceManagement/virtualEndpoint/provisioningPolicies/{id}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto cloudPcProvisioningPolicy .

En la tabla siguiente se muestran las propiedades que se pueden actualizar para cloudPcProvisioningPolicy.

Propiedad Tipo Descripción
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 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.
autopilotConfiguration cloudPcAutopilotConfiguration La configuración específica de Windows Autopilot que permite a los clientes de Windows 365 experimentarlo en PC en la nube. La actualización de autopilotConfiguration requiere los permisos enumerados en la sección Permisos de esta API. En escenarios delegados, el usuario que ha iniciado sesión también debe tener el permiso RBAC de Microsoft.Intune/DeviceConfigurations/Assign Intune.
description Cadena Descripción de la directiva de aprovisionamiento.
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.
enableSingleSignOn Booleano True si se puede acceder al PC en la nube aprovisionado mediante el inicio de sesión único. 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.
imageDisplayName Cadena El nombre para mostrar de la imagen del sistema operativo que estás aprovisionando.
identificador de imagen Cadena El Id. de la imagen del sistema operativo que desea aprovisionar en equipos en la nube. El formato de una imagen de tipo galería es: {publisher_offer_sku}. Los valores admitidos para cada uno de los parámetros son los siguientes:
  • Editor: 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-M365, 20H1-ENT-CPC-OS, 19H2-ENT-CPC-M365 y 19H2-ENT-CPC-OS.
tipo de imagen cloudPcProvisioningPolicyImageType El tipo de imagen del sistema operativo (personalizada o de galería) que desea aprovisionar en equipos en la nube. Los valores posibles son: gallery, custom.
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.
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.
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 asegurarte de que los PC en la nube tienen conectividad de red y se unen a un dominio, elige una conexión con una red virtual validada por el servicio de PC en la nube. 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 .

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "displayName": "HR provisioning policy",
  "description": "Provisioning policy for India HR employees",
  "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
  "imageId": "Image ID value",
  "imageDisplayName": "Image Display Name value",
  "imageType": "custom",
  "windowsSettings": {
    "language": "en-US"
  },
  "windowsSetting": {
    "locale": "en-US"
  },
  "microsoftManagedDesktop": {
    "managedType": "starterManaged",
    "profile": null
  },
  "autopatch": {
    "autopatchGroupId": "91197a0b-3a74-408d-ba88-bce3fdc4e5eb"
  },
  "autopilotConfiguration": {
    "devicePreparationProfileId": "59e5d3d2-ec68-4bfe-9693-27975b318990",
    "applicationTimeoutInMinutes": 30,
    "onFailureDeviceAccessDenied": false
  },
  "userSettingsPersistenceConfiguration": {
    "userSettingsPersistenceEnabled": false,
    "userSettingsPersistenceStorageSizeCategory": "fourGB"
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content