Atualizar depEnrollmentProfile

Namespace: microsoft.graph

Importante: As APIs Graph 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 depEnrollmentProfile .

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
Delegada (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementServiceConfig.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles/{enrollmentProfileId}

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

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

Propriedade	Tipo	Descrição
id	String	O GUID do objeto Herdado de enrollmentProfile
displayName	String	Nome do perfil Herdado de enrollmentProfile
descrição	String	Descrição do perfil Herdado de enrollmentProfile
requiresUserAuthentication	Booleano	Indica se o perfil requer autenticação de usuário Herdada de enrollmentProfile
configurationEndpointUrl	String	URL do ponto de extremidade de configuração a ser usada para Registro Herdado de enrollmentProfile
enableAuthenticationViaCompanyPortal	Boolean	Indica a autenticação com o Assistente de Instalação da Apple em vez de Portal da Empresa. Herdado de enrollmentProfile
requireCompanyPortalOnSetupAssistantEnrolledDevices	Booleano	Indica que a Portal da Empresa é necessária em dispositivos inscritos do assistente de instalação Herdados de enrollmentProfile
isDefault	Booliano	Indica se esse é o perfil padrão
supervisedModeEnabled	Booliano	Modo supervisionado, True para habilitar, false caso contrário. Consulte Registrar dispositivos no Microsoft Intune para obter informações adicionais.
supportDepartment	String	Informações do departamento de suporte
passCodeDisabled	Boolean	Indica se o painel de configuração senha está desabilitado
isMandatory	Booliano	Indica se o perfil é obrigatório
locationDisabled	Booliano	Indica se o painel de configuração do serviço de localização está desabilitado
supportPhoneNumber	String	Número de telefone de suporte
iTunesPairingMode	iTunesPairingMode	Indica o modo de emparelhamento do iTunes. Os valores possíveis são: disallow, allow, requiresCertificate.
profileRemovalDisabled	Boolean	Indica se a opção de remoção de perfil está desabilitada
managementCertificates	coleção managementCertificateWithThumbprint	Certificados de gerenciamento para o Apple Configurator
restoreBlocked	Boolean	Indica se o painel restaurar instalação está bloqueado
restoreFromAndroidDisabled	Booliano	Indica se a restauração do Android está desabilitada
appleIdDisabled	Booleano	Indica se o painel de configuração de ID da Apple está desabilitado
termsAndConditionsDisabled	Booleano	Indica se o painel de configuração 'Termos e Condições' está desabilitado
touchIdDisabled	Boolean	Indica se o painel de configuração de ID por toque está desabilitado
applePayDisabled	Boolean	Indica se o painel de configuração de pagamento da Apple está desabilitado
zoomDisabled	Booliano	Indica se o painel de configuração de zoom está desabilitado
siriDisabled	Boolean	Indica se o painel de configuração de siri está desabilitado
diagnosticsDisabled	Booliano	Indica se o painel de configuração de diagnósticos está desabilitado
macOSRegistrationDisabled	Booliano	Indica se o registro do Mac OS está desabilitado
macOSFileVaultDisabled	Booleano	Indica se o cofre de arquivos do Mac OS está desabilitado
awaitDeviceConfiguredConfirmation	Booleano	Indica se o dispositivo precisará aguardar a confirmação configurada
sharedIPadMaximumUserCount	Int32	Isso especifica o número máximo de usuários que podem usar um iPad. Aplicável somente no modo iPad compartilhado.
enableSharedIPad	Booleano	Isso indica se o dispositivo deve ser inscrito em um modo que habilita cenários de vários usuários. Aplicável somente em iPads compartilhados.

Resposta

Se tiver êxito, este método retornará um 200 OK código de resposta e um objeto depEnrollmentProfile atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles/{enrollmentProfileId}
Content-type: application/json
Content-length: 1354

{
  "@odata.type": "#microsoft.graph.depEnrollmentProfile",
  "displayName": "Display Name value",
  "description": "Description value",
  "requiresUserAuthentication": true,
  "configurationEndpointUrl": "https://example.com/configurationEndpointUrl/",
  "enableAuthenticationViaCompanyPortal": true,
  "requireCompanyPortalOnSetupAssistantEnrolledDevices": true,
  "isDefault": true,
  "supervisedModeEnabled": true,
  "supportDepartment": "Support Department value",
  "passCodeDisabled": true,
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "iTunesPairingMode": "allow",
  "profileRemovalDisabled": true,
  "managementCertificates": [
    {
      "@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
      "thumbprint": "Thumbprint value",
      "certificate": "Certificate value"
    }
  ],
  "restoreBlocked": true,
  "restoreFromAndroidDisabled": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "zoomDisabled": true,
  "siriDisabled": true,
  "diagnosticsDisabled": true,
  "macOSRegistrationDisabled": true,
  "macOSFileVaultDisabled": true,
  "awaitDeviceConfiguredConfirmation": true,
  "sharedIPadMaximumUserCount": 10,
  "enableSharedIPad": true
}

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: 1403

{
  "@odata.type": "#microsoft.graph.depEnrollmentProfile",
  "id": "3d4534f7-34f7-3d45-f734-453df734453d",
  "displayName": "Display Name value",
  "description": "Description value",
  "requiresUserAuthentication": true,
  "configurationEndpointUrl": "https://example.com/configurationEndpointUrl/",
  "enableAuthenticationViaCompanyPortal": true,
  "requireCompanyPortalOnSetupAssistantEnrolledDevices": true,
  "isDefault": true,
  "supervisedModeEnabled": true,
  "supportDepartment": "Support Department value",
  "passCodeDisabled": true,
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "iTunesPairingMode": "allow",
  "profileRemovalDisabled": true,
  "managementCertificates": [
    {
      "@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
      "thumbprint": "Thumbprint value",
      "certificate": "Certificate value"
    }
  ],
  "restoreBlocked": true,
  "restoreFromAndroidDisabled": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "zoomDisabled": true,
  "siriDisabled": true,
  "diagnosticsDisabled": true,
  "macOSRegistrationDisabled": true,
  "macOSFileVaultDisabled": true,
  "awaitDeviceConfiguredConfirmation": true,
  "sharedIPadMaximumUserCount": 10,
  "enableSharedIPad": true
}