ActiveDirectoryWindowsAutopilotDeploymentProfile aktualisierenUpdate activeDirectoryWindowsAutopilotDeploymentProfile

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der/Beta-Version können Änderungen unterworfen werden; die Produktions Verwendung wird nicht unterstützt.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Aktualisieren der Eigenschaften eines activeDirectoryWindowsAutopilotDeploymentProfile -Objekts.Update the properties of a activeDirectoryWindowsAutopilotDeploymentProfile object.

VoraussetzungenPrerequisites

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den meisten Rechten zu der mit den wenigsten Rechten)Permissions (from most to least privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All

HTTP-AnforderungHTTP Request

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

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer<token> erforderlichBearer <token> Required.
AnnehmenAccept application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung für das activeDirectoryWindowsAutopilotDeploymentProfile -Objekt an.In the request body, supply a JSON representation for the activeDirectoryWindowsAutopilotDeploymentProfile object.

In der folgenden Tabelle sind die Eigenschaften dargestellt, die zum Erstellen der activeDirectoryWindowsAutopilotDeploymentProfileerforderlich sind.The following table shows the properties that are required when you create the activeDirectoryWindowsAutopilotDeploymentProfile.

EigenschaftProperty TypType BeschreibungDescription
idid ZeichenfolgeString Von windowsautopilotdeploymentprofile hinzugefügt geerbter ProfilschlüsselProfile Key Inherited from windowsAutopilotDeploymentProfile
displayNamedisplayName ZeichenfolgeString Name des von windowsautopilotdeploymentprofile hinzugefügt geerbten ProfilsName of the profile Inherited from windowsAutopilotDeploymentProfile
descriptiondescription StringString Beschreibung des von windowsautopilotdeploymentprofile hinzugefügt geerbten ProfilsDescription of the profile Inherited from windowsAutopilotDeploymentProfile
languagelanguage StringString Auf dem von windowsautopilotdeploymentprofile hinzugefügt geerbtes Gerät konfigurierte SpracheLanguage configured on the device Inherited from windowsAutopilotDeploymentProfile
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Von windowsautopilotdeploymentprofile hinzugefügt geerbte Profil ErstellungszeitProfile creation time Inherited from windowsAutopilotDeploymentProfile
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Von windowsautopilotdeploymentprofile hinzugefügt geerbte Profil-Uhrzeit der letzten ÄnderungProfile last modified time Inherited from windowsAutopilotDeploymentProfile
outOfBoxExperienceSettingsoutOfBoxExperienceSettings outOfBoxExperienceSettingsoutOfBoxExperienceSettings Von windowsautopilotdeploymentprofile hinzugefügt geerbte Einstellung für die Out-of-Box-ErfahrungOut of box experience setting Inherited from windowsAutopilotDeploymentProfile
enrollmentStatusScreenSettingsenrollmentStatusScreenSettings windowsEnrollmentStatusScreenSettingswindowsEnrollmentStatusScreenSettings Von windowsautopilotdeploymentprofile hinzugefügt geerbte Registrierungsstatus BildschirmeinstellungEnrollment status screen setting Inherited from windowsAutopilotDeploymentProfile
extractHardwareHashextractHardwareHash BooleschBoolean HardwareHash-Extraktion für das von windowsautopilotdeploymentprofile hinzugefügt geerbte ProfilHardwareHash Extraction for the profile Inherited from windowsAutopilotDeploymentProfile
deviceNameTemplatedeviceNameTemplate ZeichenfolgeString Die zum Benennen des Autopilot-Geräts verwendete Vorlage.The template used to name the AutoPilot Device. Hierbei kann es sich um einen benutzerdefinierten Text handeln, der auch die Seriennummer des Geräts oder eine zufällig generierte Zahl enthalten kann.This can be a custom text and can also contain either the serial number of the device, or a randomly generated number. Die Gesamtlänge des von der Vorlage generierten Texts darf nicht mehr als 15 Zeichen lang sein.The total length of the text generated by the template can be no more than 15 characters. Geerbt von windowsautopilotdeploymentprofile hinzugefügtInherited from windowsAutopilotDeploymentProfile
deviceTypedeviceType windowsAutopilotDeviceTypewindowsAutopilotDeviceType Der Autopilot-Gerätetyp, auf den dieses Profil angewendet wird.The AutoPilot device type that this profile is applicable to. Geerbt von windowsautopilotdeploymentprofile hinzugefügt.Inherited from windowsAutopilotDeploymentProfile. Mögliche Werte sind: windowsPc, surfaceHub2 und holoLens.Possible values are: windowsPc, surfaceHub2, holoLens.
enableWhiteGloveenableWhiteGlove BooleschBoolean Aktivieren Sie den weißen Handschuh Autopilot für das Profil.Enable Autopilot White Glove for the profile. Geerbt von windowsautopilotdeploymentprofile hinzugefügtInherited from windowsAutopilotDeploymentProfile
rolescopetagids zurroleScopeTagIds String-SammlungString collection Bereichs Tags für das Profil.Scope tags for the profile. Geerbt von windowsautopilotdeploymentprofile hinzugefügtInherited from windowsAutopilotDeploymentProfile
hybridAzureADJoinSkipConnectivityCheckhybridAzureADJoinSkipConnectivityCheck BooleschBoolean Der Autopilot-Hybrid Azure AD Verknüpfungs Fluss wird auch dann fortgesetzt, wenn keine Domänencontroller-Konnektivität während OOBE hergestellt wird.The Autopilot Hybrid Azure AD join flow will continue even if it does not establish domain controller connectivity during OOBE.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200 OK werden der Antwortcode und ein aktualisiertes activeDirectoryWindowsAutopilotDeploymentProfile -Objekt im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and an updated activeDirectoryWindowsAutopilotDeploymentProfile object in the response body.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

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

{
  "@odata.type": "#microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile",
  "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"
  ],
  "hybridAzureADJoinSkipConnectivityCheck": true
}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "@odata.type": "#microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile",
  "id": "49fe234a-234a-49fe-4a23-fe494a23fe49",
  "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"
  ],
  "hybridAzureADJoinSkipConnectivityCheck": true
}