WindowsDomainJoinConfiguration aktualisieren

Namespace: microsoft.graph

Wichtig: APIs unter der /beta-Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Aktualisieren der Eigenschaften eines windowsDomainJoinConfiguration-Objekts.

Voraussetzungen

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.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den meisten Rechten zu der mit den wenigsten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)
Gerätekonfiguration	DeviceManagementConfiguration.ReadWrite.All
Registrierung	DeviceManagementServiceConfig.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung
Gerätekonfiguration	DeviceManagementConfiguration.ReadWrite.All
Registrierung	DeviceManagementServiceConfig.ReadWrite.All

HTTP-Anforderung

Gerätekonfiguration

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}

Registrierung

PATCH /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/deploymentProfile/microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile/domainJoinConfiguration

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer<token> erforderlich
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Objekts des Typs "windowsDomainJoinConfiguration" an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs "windowsDomainJoinConfiguration"erstellen.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Schlüssel der Entität Geerbt von deviceConfiguration.
Gerätekonfiguration
activeDirectoryDomainName	Zeichenfolge	Active Directory-Domänenname für den Beitritt.
computerNameStaticPrefix	Zeichenfolge	Festes Präfix, das für den Computernamen verwendet werden soll.
computerNameSuffixRandomCharCount	Int32	Dynamisch generierte Zeichen, die als Suffix für den Computernamen verwendet werden. Gültige Werte: 3 bis 14
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration.
description	Zeichenfolge	Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration.
displayName	Zeichenfolge	Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration.
Organizationalunit	Zeichenfolge	Organisationseinheit (OU), in der das Computerkonto erstellt wird. Wenn dieser Parameter NULL ist, wird der bekannte Computerobjektcontainer als in der Domäne veröffentlicht verwendet.
roleScopeTagIds	Zeichenfolgenauflistung	Liste der Bereichstags für diese Entitätsinstanz. Geerbt von deviceConfiguration.
supportsScopeTags	Boolean	Gibt an, ob die zugrunde liegende Gerätekonfiguration die Zuweisung von Bereichstags unterstützt. Das Zuweisen zur ScopeTags-Eigenschaft ist nicht zulässig, wenn dieser Wert false ist und Entitäten für bereichsbezogene Benutzer nicht sichtbar sind. Dies geschieht für Legacyrichtlinien, die in Silverlight erstellt wurden, und kann durch Löschen und Erneutes Erstellen der Richtlinie im Azure-Portal behoben werden. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration.
Version	Int32	Version der Gerätekonfiguration. Geerbt von deviceConfiguration.

Hinweis: Die Unterstützung von Anforderungstexteigenschaften hängt vom Kontext des Aufrufs ab. Nicht alle Eigenschaften sind für alle Workflows geeignet.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes Objekt des Typs "windowsDomainJoinConfiguration" im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 344

{
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "computerNameStaticPrefix": "Computer Name Static Prefix value",
  "computerNameSuffixRandomCharCount": 1,
  "activeDirectoryDomainName": "Active Directory Domain Name value"
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Eigenschaften, die von tatsächlichen Aufrufen zurückgegeben werden, variieren je nach Kontext.

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

{
  "@odata.type": "#microsoft.graph.windowsDomainJoinConfiguration",
  "id": "40118d08-8d08-4011-088d-1140088d1140",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "computerNameStaticPrefix": "Computer Name Static Prefix value",
  "computerNameSuffixRandomCharCount": 1,
  "activeDirectoryDomainName": "Active Directory Domain Name value"
}