Compartir a través de

Actualización de azureADWindowsAutopilotDeploymentProfile

  • Artículo

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Actualice las propiedades de un objeto azureADWindowsAutopilotDeploymentProfile .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

PATCH /deviceManagement/windowsAutopilotDeploymentProfiles/{windowsAutopilotDeploymentProfileId}
PATCH /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/deploymentProfile
PATCH /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/intendedDeploymentProfile

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto azureADWindowsAutopilotDeploymentProfile .

En la tabla siguiente se muestran las propiedades necesarias al crear azureADWindowsAutopilotDeploymentProfile.

Propiedad Tipo Descripción
id Cadena Clave de perfil heredada de windowsAutopilotDeploymentProfile
displayName Cadena Nombre para mostrar del perfil de implementación. La longitud máxima permitida es de 200 caracteres. Se devuelve por defecto. Admite: $select, $top, $skip, $orderby. no se admiten $Search ni $filter. Heredado de windowsAutopilotDeploymentProfile
description Cadena Descripción del perfil de implementación. La longitud máxima permitida es de 1500 caracteres. Admite: $select, $top, $skip, $orderBy. no se admiten $Search ni $filter. Heredado de windowsAutopilotDeploymentProfile
language Cadena Código de idioma que se va a usar al configurar el dispositivo. Por ejemplo, en-US. El valor predeterminado es os-default. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Solo lectura. A partir de mayo de 2024 esta propiedad ya no se admitirá y se marcará como en desuso. Use la configuración regional en su lugar. Heredado de windowsAutopilotDeploymentProfile
configuración regional Cadena Configuración regional (idioma) que se va a usar al configurar el dispositivo. Por ejemplo, en-US. El valor predeterminado es os-default. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Heredado de windowsAutopilotDeploymentProfile
createdDateTime DateTimeOffset Fecha y hora de la creación del perfil de implementación. El valor no se puede modificar y se rellena automáticamente cuando se creó el perfil. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 sería así: "2014-01-01T00:00:00Z". Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Solo lectura. Heredado de windowsAutopilotDeploymentProfile
lastModifiedDateTime DateTimeOffset Fecha y hora de la última modificación del perfil de implementación. El valor no se puede actualizar manualmente y se rellena automáticamente cuando se realizan cambios en el perfil. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 sería así: "2014-01-01T00:00:00Z". Admite: $select, $top, $skip. $Search, $orderBy y $filter no se admiten de solo lectura. Heredado de windowsAutopilotDeploymentProfile
outOfBoxExperienceSettings outOfBoxExperienceSettings La configuración del perfil de Windows Autopilot Deployment que usa el dispositivo Autopilot para la experiencia rápida. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Solo lectura. A partir de mayo de 2024 esta propiedad ya no se admitirá y se marcará como en desuso. En su lugar, use outOfBoxExperienceSetting. Heredado de windowsAutopilotDeploymentProfile
outOfBoxExperienceSetting outOfBoxExperienceSetting La configuración del perfil de Windows Autopilot Deployment que usa el dispositivo para la experiencia integrada. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Heredado de windowsAutopilotDeploymentProfile
enrollmentStatusScreenSettings windowsEnrollmentStatusScreenSettings Configuración de pantalla de estado de inscripción Heredada de windowsAutopilotDeploymentProfile
extractHardwareHash Booleano Indica si el perfil admite la extracción de valores hash de hardware y el registro del dispositivo en Windows Autopilot. Cuando es TRUE, indica si la extracción de hardware y el registro de Windows Autopilot se producirán en el siguiente check-in correcto. Cuando es FALSE, no se realizará la extracción de hash de hardware ni el registro de Windows Autopilot. El valor predeterminado es FALSE. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Solo lectura. A partir de mayo de 2024 esta propiedad ya no se admitirá y se marcará como en desuso. En su lugar, use hardwareHashExtractionEnabled. Heredado de windowsAutopilotDeploymentProfile
hardwareHashExtractionEnabled Booleano Indica si el perfil admite la extracción de valores hash de hardware y el registro del dispositivo en Windows Autopilot. Cuando es TRUE, indica si la extracción de hardware y el registro de Windows Autopilot se producirán en el siguiente check-in correcto. Cuando es FALSE, no se realizará la extracción de hash de hardware ni el registro de Windows Autopilot. El valor predeterminado es FALSE. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Heredado de windowsAutopilotDeploymentProfile
deviceNameTemplate Cadena Plantilla usada para asignar un nombre al dispositivo Autopilot. Puede ser un texto personalizado y también puede contener el número de serie del dispositivo o un número generado aleatoriamente. La longitud total del texto generado por la plantilla no puede tener más de 15 caracteres. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Heredado de windowsAutopilotDeploymentProfile
deviceType windowsAutopilotDeviceType Tipo de dispositivo Windows al que se aplica este perfil. Entre los valores posibles se incluyen windowsPc, holoLens y virtualMachine. El valor predeterminado es windowsPc. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Se hereda de windowsAutopilotDeploymentProfile. Los valores posibles son: windowsPc, holoLens, surfaceHub2, surfaceHub2S, virtualMachine, unknownFutureValue.
enableWhiteGlove Booleano Indica si el usuario puede usar Windows Autopilot para el modo de implementación aprovisionado previamente durante la experiencia de configuración rápida (OOBE). Cuando es TRUE, indica que se permite Windows Autopilot para el modo de implementación aprovisionado previamente. Cuando es false, no se permite Windows Autopilot para el modo de implementación aprovisionado previamente. El valor predeterminado es FALSE (falso). Solo lectura. A partir de mayo de 2024 esta propiedad ya no se admitirá y se marcará como en desuso. Use preprovisioningAllowed en su lugar. Heredado de windowsAutopilotDeploymentProfile
preprovisioningAllowed Booleano Indica si el usuario puede usar Windows Autopilot para el modo de implementación aprovisionado previamente durante la experiencia de configuración rápida (OOBE). Cuando es TRUE, indica que se permite usar Windows Autopilot para el modo de implementación aprovisionado previamente para OOBE. Cuando es false, no se permite Windows Autopilot para el modo de implementación aprovisionado previamente para OOBE. El valor predeterminado es FALSE (falso). Heredado de windowsAutopilotDeploymentProfile
roleScopeTagIds Colección string Lista de etiquetas de ámbito de rol para el perfil de implementación. Heredado de windowsAutopilotDeploymentProfile
managementServiceAppId Cadena Identificador de aplicación del servicio de administración de Entra que se usa durante la detección de inscripción basada en dispositivos cliente. Admite: $select, $top, $skip. no se admiten $Search, $orderBy ni $filter. Heredado de windowsAutopilotDeploymentProfile

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto azureADWindowsAutopilotDeploymentProfile actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeploymentProfiles/{windowsAutopilotDeploymentProfileId}
Content-type: application/json
Content-length: 1628

{
  "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
  "displayName": "Display Name value",
  "description": "Description value",
  "language": "Language value",
  "locale": "Locale value",
  "outOfBoxExperienceSettings": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
    "hidePrivacySettings": true,
    "hideEULA": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "skipKeyboardSelectionPage": true,
    "hideEscapeLink": true
  },
  "outOfBoxExperienceSetting": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
    "privacySettingsHidden": true,
    "eulaHidden": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "keyboardSelectionPageSkipped": true,
    "escapeLinkHidden": true
  },
  "enrollmentStatusScreenSettings": {
    "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
    "hideInstallationProgress": true,
    "allowDeviceUseBeforeProfileAndAppInstallComplete": true,
    "blockDeviceSetupRetryByUser": true,
    "allowLogCollectionOnInstallFailure": true,
    "customErrorMessage": "Custom Error Message value",
    "installProgressTimeoutInMinutes": 15,
    "allowDeviceUseOnInstallFailure": true
  },
  "extractHardwareHash": true,
  "hardwareHashExtractionEnabled": true,
  "deviceNameTemplate": "Device Name Template value",
  "deviceType": "holoLens",
  "enableWhiteGlove": true,
  "preprovisioningAllowed": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "managementServiceAppId": "Management Service App Id value"
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1800

{
  "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
  "id": "e2ec4e69-4e69-e2ec-694e-ece2694eece2",
  "displayName": "Display Name value",
  "description": "Description value",
  "language": "Language value",
  "locale": "Locale value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "outOfBoxExperienceSettings": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
    "hidePrivacySettings": true,
    "hideEULA": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "skipKeyboardSelectionPage": true,
    "hideEscapeLink": true
  },
  "outOfBoxExperienceSetting": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
    "privacySettingsHidden": true,
    "eulaHidden": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "keyboardSelectionPageSkipped": true,
    "escapeLinkHidden": true
  },
  "enrollmentStatusScreenSettings": {
    "@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
    "hideInstallationProgress": true,
    "allowDeviceUseBeforeProfileAndAppInstallComplete": true,
    "blockDeviceSetupRetryByUser": true,
    "allowLogCollectionOnInstallFailure": true,
    "customErrorMessage": "Custom Error Message value",
    "installProgressTimeoutInMinutes": 15,
    "allowDeviceUseOnInstallFailure": true
  },
  "extractHardwareHash": true,
  "hardwareHashExtractionEnabled": true,
  "deviceNameTemplate": "Device Name Template value",
  "deviceType": "holoLens",
  "enableWhiteGlove": true,
  "preprovisioningAllowed": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "managementServiceAppId": "Management Service App Id value"
}