Erstellen von deviceComanagementAuthorityConfiguration
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Erstellen Sie ein neues deviceComanagementAuthorityConfiguration-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
POST /deviceManagement/deviceEnrollmentConfigurations
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das Objekt deviceComanagementAuthorityConfiguration an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von deviceComanagementAuthorityConfiguration erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | Zeichenfolge | Eindeutiger Bezeichner für das Konto, das von deviceEnrollmentConfiguration geerbt wurde |
displayName | Zeichenfolge | Der Anzeigename der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde. |
description | Zeichenfolge | Die Beschreibung der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde. |
Priorität | Int32 | Priorität wird verwendet, wenn ein Benutzer in mehreren Gruppen vorhanden ist, denen die Registrierungskonfiguration zugewiesen ist. Benutzer unterliegen nur der Konfiguration mit dem niedrigsten Prioritätswert. Geerbt von deviceEnrollmentConfiguration |
createdDateTime | DateTimeOffset | Datum und Uhrzeit der Erstellung in UTC der Geräteregistrierungskonfiguration geerbt von deviceEnrollmentConfiguration |
lastModifiedDateTime | DateTimeOffset | Datum der letzten Änderung in UTC der Geräteregistrierungskonfiguration geerbt von deviceEnrollmentConfiguration |
Version | Int32 | Die Version der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde |
roleScopeTagIds | Zeichenfolgensammlung | Optionale Rollenbereichstags für die Registrierungseinschränkungen. Geerbt von deviceEnrollmentConfiguration |
deviceEnrollmentConfigurationType | deviceEnrollmentConfigurationType | Unterstützung für registrierungskonfigurationstyp Geerbt von deviceEnrollmentConfiguration. Mögliche Werte: unknown , limit , platformRestrictions , windowsHelloForBusiness , defaultLimit , defaultPlatformRestrictions , defaultWindowsHelloForBusiness , defaultWindows10EnrollmentCompletionPageConfiguration , windows10EnrollmentCompletionPageConfiguration , deviceComanagementAuthorityConfiguration , singlePlatformRestriction , unknownFutureValue , enrollmentNotificationsConfiguration . |
managedDeviceAuthority | Int32 | CoManagement Authority configuration ManagedDeviceAuthority |
installConfigurationManagerAgent | Boolesch | Konfiguration der CoManagement-Autorität InstallConfigurationManagerAgent |
configurationManagerAgentCommandLineArgument | Zeichenfolge | Konfiguration der CoManagement-Autorität ConfigurationManagerAgentCommandLineArgument |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 201 Created
Antwortcode und ein deviceComanagementAuthorityConfiguration-Objekt im Antworttext zurückgegeben.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations
Content-type: application/json
Content-length: 494
{
"@odata.type": "#microsoft.graph.deviceComanagementAuthorityConfiguration",
"displayName": "Display Name value",
"description": "Description value",
"priority": 8,
"version": 7,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deviceEnrollmentConfigurationType": "limit",
"managedDeviceAuthority": 6,
"installConfigurationManagerAgent": true,
"configurationManagerAgentCommandLineArgument": "Configuration Manager Agent Command Line Argument value"
}
Antwort
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.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 666
{
"@odata.type": "#microsoft.graph.deviceComanagementAuthorityConfiguration",
"id": "0ba0057f-057f-0ba0-7f05-a00b7f05a00b",
"displayName": "Display Name value",
"description": "Description value",
"priority": 8,
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"version": 7,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deviceEnrollmentConfigurationType": "limit",
"managedDeviceAuthority": 6,
"installConfigurationManagerAgent": true,
"configurationManagerAgentCommandLineArgument": "Configuration Manager Agent Command Line Argument value"
}