Compartilhar via

Atualizar azureADWindowsAutopilotDeploymentProfile

  • Artigo

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Atualize as propriedades de um objeto azureADWindowsAutopilotDeploymentProfile .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

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

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON para o objeto azureADWindowsAutopilotDeploymentProfile .

A tabela seguinte mostra as propriedades necessárias quando cria o azureADWindowsAutopilotDeploymentProfile.

Propriedade Tipo Descrição
id Cadeia de caracteres Chave de Perfil Herdada do windowsAutopilotDeploymentProfile
displayName Cadeia de caracteres O nome a apresentar do perfil de implementação. O comprimento máximo permitido é de 200 carateres. Devolvido por padrão. Suportes: $select, $top, $skip $orderby. $Search e $filter não são suportados. Herdado de windowsAutopilotDeploymentProfile
description Cadeia de caracteres Uma descrição do perfil de implementação. O comprimento máximo permitido é de 1500 carateres. Suporta: $select, $top, $skip $orderBy. $Search e $filter não são suportados. Herdado de windowsAutopilotDeploymentProfile
idioma Cadeia de caracteres O código de idioma a utilizar ao configurar o dispositivo. Por exemplo, en-US. O valor predefinido é os-default. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Somente Leitura. A partir de maio de 2024, esta propriedade deixará de ser suportada e será marcada como preterida. Em alternativa, utilize a região. Herdado de windowsAutopilotDeploymentProfile
localidade Cadeia de caracteres A região (idioma) a ser utilizada ao configurar o dispositivo. Por exemplo, en-US. O valor predefinido é os-default. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Herdado de windowsAutopilotDeploymentProfile
createdDateTime DateTimeOffset A data e hora da criação do perfil de implementação. Não é possível modificar o valor e é preenchido automaticamente quando o perfil foi criado. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Somente Leitura. Herdado de windowsAutopilotDeploymentProfile
lastModifiedDateTime DateTimeOffset A data e hora da última modificação do perfil de implementação. O valor não pode ser atualizado manualmente e é preenchido automaticamente quando são efetuadas alterações ao perfil. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados como Só de Leitura. Herdado de windowsAutopilotDeploymentProfile
outOfBoxExperienceSettings outOfBoxExperienceSettings As definições de Perfil do Windows Autopilot Deployment utilizadas pelo dispositivo Autopilot para uma experiência inicial. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Somente Leitura. A partir de maio de 2024, esta propriedade deixará de ser suportada e será marcada como preterida. Em alternativa, utilize outOfBoxExperienceSetting. Herdado de windowsAutopilotDeploymentProfile
outOfBoxExperienceSetting outOfBoxExperienceSetting As definições de Perfil do Windows Autopilot Deployment utilizadas pelo dispositivo para a experiência inicial. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Herdado de windowsAutopilotDeploymentProfile
enrollmentStatusScreenSettings windowsEnrollmentStatusScreenSettings Definição do ecrã status inscrição Herdado do windowsAutopilotDeploymentProfile
extractHardwareHash Booliano Indica se o perfil suporta a extração de valores hash de hardware e o registo do dispositivo no Windows Autopilot. Quando VERDADEIRO, indica se a extração de hardware e o registo do Windows Autopilot ocorrerão na próxima marcar de entrada bem-sucedida. Quando FALSO, a extração de hash de hardware e o registo do Windows Autopilot não ocorrerão. O valor predefinido é FALSO. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Somente Leitura. A partir de maio de 2024, esta propriedade deixará de ser suportada e será marcada como preterida. Em alternativa, utilize hardwareHashExtractionEnabled. Herdado de windowsAutopilotDeploymentProfile
hardwareHashExtractionEnabled Booliano Indica se o perfil suporta a extração de valores hash de hardware e o registo do dispositivo no Windows Autopilot. Quando VERDADEIRO, indica se a extração de hardware e o registo do Windows Autopilot ocorrerão na próxima marcar de entrada bem-sucedida. Quando FALSO, a extração de hash de hardware e o registo do Windows Autopilot não ocorrerão. O valor predefinido é FALSO. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Herdado de windowsAutopilotDeploymentProfile
deviceNameTemplate Cadeia de caracteres O modelo utilizado para atribuir um nome ao dispositivo Autopilot. Pode ser um texto personalizado e também pode conter o número de série do dispositivo ou um número gerado aleatoriamente. O comprimento total do texto gerado pelo modelo não pode ter mais de 15 carateres. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Herdado de windowsAutopilotDeploymentProfile
deviceType windowsAutopilotDeviceType O tipo de dispositivo Windows a que este perfil é aplicável. Os valores possíveis incluem windowsPc, holoLens e virtualMachine. A predefinição é windowsPc. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Herdado de windowsAutopilotDeploymentProfile. Os possíveis valores são: windowsPc, holoLens, surfaceHub2, surfaceHub2S, virtualMachine, unknownFutureValue.
enableWhiteGlove Booliano Indica se o utilizador tem permissão para utilizar o Windows Autopilot para o modo de implementação pré-aprovisionado durante a experiência Out of Box (OOBE). Quando VERDADEIRO, indica que o Windows Autopilot para o modo de implementação pré-aprovisionado é permitido. Quando falso, o Windows Autopilot para o modo de implementação pré-aprovisionado não é permitido. O padrão é FALSO. Somente Leitura. A partir de maio de 2024, esta propriedade deixará de ser suportada e será marcada como preterida. Em alternativa, utilize pré-aprovisionamentoPermitido. Herdado de windowsAutopilotDeploymentProfile
pré-aprovisionamentoPermitido Booliano Indica se o utilizador tem permissão para utilizar o Windows Autopilot para o modo de implementação pré-aprovisionado durante a experiência Out of Box (OOBE). Quando VERDADEIRO, indica que o Windows Autopilot para o modo de implementação pré-aprovisionado para OOBE tem permissão para ser utilizado. Quando falso, o Windows Autopilot para o modo de implementação pré-aprovisionado para OOBE não é permitido. O padrão é FALSO. Herdado de windowsAutopilotDeploymentProfile
roleScopeTagIds String collection Lista de etiquetas de âmbito de função para o perfil de implementação. Herdado de windowsAutopilotDeploymentProfile
managementServiceAppId Cadeia de caracteres O ID da Aplicação do serviço de gestão Entra que é utilizado durante a deteção da inscrição baseada no dispositivo cliente. Suporta: $select, $top, $skip. $Search, $orderBy e $filter não são suportados. Herdado de windowsAutopilotDeploymentProfile

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto azureADWindowsAutopilotDeploymentProfile atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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"
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada 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"
}