Atualizar azureADWindowsAutopilotDeploymentProfile

Namespace: microsoft.graph

Importante: As GRAPH da Microsoft na versão /beta estão sujeitas a alterações; o uso de produção não é suportado.

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.

Pré-requisitos

Uma das seguintes permissões é obrigató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
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementServiceConfig.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.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON para o objeto azureADWindowsAutopilotDeploymentProfile.

A tabela a seguir mostra as propriedades que são necessárias ao criar o azureADWindowsAutopilotDeploymentProfile.

Propriedade	Tipo	Descrição
id	String	Chave de Perfil Herdada do windowsAutopilotDeploymentProfile
displayName	String	Nome do perfil Herdado do windowsAutopilotDeploymentProfile
description	String	Descrição do perfil Herdado do windowsAutopilotDeploymentProfile
idioma	Cadeia de caracteres	Idioma configurado no dispositivo Herdado do windowsAutopilotDeploymentProfile
createdDateTime	DateTimeOffset	Tempo de criação de perfil Herdado do windowsAutopilotDeploymentProfile
lastModifiedDateTime	DateTimeOffset	Tempo de última modificação do perfil Herdado do windowsAutopilotDeploymentProfile
outOfBoxExperienceSettings	outOfBoxExperienceSettings	Configuração de experiência fora de caixa Herdada do windowsAutopilotDeploymentProfile
enrollmentStatusScreenSettings	windowsEnrollmentStatusScreenSettings	Configuração da tela de status de registro Herdada do windowsAutopilotDeploymentProfile
extractHardwareHash	Boolean	Extração de HardwareHash para o perfil Herdado do windowsAutopilotDeploymentProfile
deviceNameTemplate	String	O modelo usado para nomear o 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 caracteres. Herdado do windowsAutopilotDeploymentProfile
deviceType	windowsAutopilotDeviceType	O tipo de dispositivo AutoPilot ao qual esse perfil é aplicável. Herdado do windowsAutopilotDeploymentProfile. Os possíveis valores são: windowsPc, surfaceHub2, holoLens, surfaceHub2S, virtualMachine, unknownFutureValue.
enableWhiteGlove	Booliano	Habilitar o Autopilot White Glove para o perfil. Herdado do windowsAutopilotDeploymentProfile
roleScopeTagIds	Coleção de cadeias de caracteres	Marcas de escopo para o perfil. Herdado do windowsAutopilotDeploymentProfile
managementServiceAppId	String	ID do aplicativo de gerenciamento do AzureAD usada durante a descoberta de registro baseada em dispositivo cliente Herdada do windowsAutopilotDeploymentProfile

Resposta

Se tiver êxito, este método retornará um código de resposta e um objeto 200 OK 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: 1223

{
  "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
  "displayName": "Display Name value",
  "description": "Description value",
  "language": "Language value",
  "outOfBoxExperienceSettings": {
    "@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
    "hidePrivacySettings": true,
    "hideEULA": true,
    "userType": "standard",
    "deviceUsageType": "shared",
    "skipKeyboardSelectionPage": true,
    "hideEscapeLink": 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,
  "deviceNameTemplate": "Device Name Template value",
  "deviceType": "surfaceHub2",
  "enableWhiteGlove": 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: 1395

{
  "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
  "id": "e2ec4e69-4e69-e2ec-694e-ece2694eece2",
  "displayName": "Display Name value",
  "description": "Description value",
  "language": "Language 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
  },
  "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,
  "deviceNameTemplate": "Device Name Template value",
  "deviceType": "surfaceHub2",
  "enableWhiteGlove": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "managementServiceAppId": "Management Service App Id value"
}