Erstellen von „editionUpgradeConfiguration“
Artikel
01/30/2024
11 Mitwirkende
Feedback
In diesem Artikel
Namespace: microsoft.graph
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Diese Methode erstellt ein neues Objekt des Typs editionUpgradeConfiguration .
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)
DeviceManagementConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)
Nicht unterstützt
Anwendung
DeviceManagementConfiguration.ReadWrite.All
HTTP-Anforderung
POST /deviceManagement/deviceConfigurations
Anforderungstext
Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs „editionUpgradeConfiguration“ an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs „editionUpgradeConfiguration“ erstellen.
Eigenschaft
Typ
Beschreibung
id
String
Schlüssel der Entität Geerbt von deviceConfiguration .
lastModifiedDateTime
DateTimeOffset
Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration .
createdDateTime
DateTimeOffset
Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration .
description
String
Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration .
displayName
String
Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration .
Version
Int32
Version der Gerätekonfiguration. Geerbt von deviceConfiguration .
licenseType
editionUpgradeLicenseType
Typ der Edition Upgrade-Lizenz. Mögliche Werte sind: productKey
und licenseFile
.
targetEdition
windows10EditionType
Zieledition von Edition Upgrade. Mögliche Werte sind: windows10Enterprise
, windows10EnterpriseN
, windows10Education
, windows10EducationN
, windows10MobileEnterprise
, windows10HolographicEnterprise
, windows10Professional
, windows10ProfessionalN
, windows10ProfessionalEducation
, windows10ProfessionalEducationN
, windows10ProfessionalWorkstation
und windows10ProfessionalWorkstationN
.
license
String
Inhalt der Edition Upgrade-Lizenzdatei
productKey
String
Product Key von Edition Upgrade
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created
und ein Objekt des Typs editionUpgradeConfiguration im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 311
{
"@odata.type": "#microsoft.graph.editionUpgradeConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"licenseType": "licenseFile",
"targetEdition": "windows10EnterpriseN",
"license": "License value",
"productKey": "Product Key value"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new EditionUpgradeConfiguration
{
OdataType = "#microsoft.graph.editionUpgradeConfiguration",
Description = "Description value",
DisplayName = "Display Name value",
Version = 7,
LicenseType = EditionUpgradeLicenseType.LicenseFile,
TargetEdition = Windows10EditionType.Windows10EnterpriseN,
License = "License value",
ProductKey = "Product Key value",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.DeviceConfigurations.PostAsync(requestBody);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
mgc device-management device-configurations create --body '{\
"@odata.type": "#microsoft.graph.editionUpgradeConfiguration",\
"description": "Description value",\
"displayName": "Display Name value",\
"version": 7,\
"licenseType": "licenseFile",\
"targetEdition": "windows10EnterpriseN",\
"license": "License value",\
"productKey": "Product Key value"\
}\
'
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewDeviceConfiguration()
description := "Description value"
requestBody.SetDescription(&description)
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName)
version := int32(7)
requestBody.SetVersion(&version)
licenseType := graphmodels.LICENSEFILE_EDITIONUPGRADELICENSETYPE
requestBody.SetLicenseType(&licenseType)
targetEdition := graphmodels.WINDOWS10ENTERPRISEN_WINDOWS10EDITIONTYPE
requestBody.SetTargetEdition(&targetEdition)
license := "License value"
requestBody.SetLicense(&license)
productKey := "Product Key value"
requestBody.SetProductKey(&productKey)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
deviceConfigurations, err := graphClient.DeviceManagement().DeviceConfigurations().Post(context.Background(), requestBody, nil)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EditionUpgradeConfiguration deviceConfiguration = new EditionUpgradeConfiguration();
deviceConfiguration.setOdataType("#microsoft.graph.editionUpgradeConfiguration");
deviceConfiguration.setDescription("Description value");
deviceConfiguration.setDisplayName("Display Name value");
deviceConfiguration.setVersion(7);
deviceConfiguration.setLicenseType(EditionUpgradeLicenseType.LicenseFile);
deviceConfiguration.setTargetEdition(Windows10EditionType.Windows10EnterpriseN);
deviceConfiguration.setLicense("License value");
deviceConfiguration.setProductKey("Product Key value");
DeviceConfiguration result = graphClient.deviceManagement().deviceConfigurations().post(deviceConfiguration);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
const options = {
authProvider,
};
const client = Client.init(options);
const deviceConfiguration = {
'@odata.type': '#microsoft.graph.editionUpgradeConfiguration',
description: 'Description value',
displayName: 'Display Name value',
version: 7,
licenseType: 'licenseFile',
targetEdition: 'windows10EnterpriseN',
license: 'License value',
productKey: 'Product Key value'
};
await client.api('/deviceManagement/deviceConfigurations')
.post(deviceConfiguration);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EditionUpgradeConfiguration;
use Microsoft\Graph\Generated\Models\EditionUpgradeLicenseType;
use Microsoft\Graph\Generated\Models\Windows10EditionType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EditionUpgradeConfiguration();
$requestBody->setOdataType('#microsoft.graph.editionUpgradeConfiguration');
$requestBody->setDescription('Description value');
$requestBody->setDisplayName('Display Name value');
$requestBody->setVersion(7);
$requestBody->setLicenseType(new EditionUpgradeLicenseType('licenseFile'));
$requestBody->setTargetEdition(new Windows10EditionType('windows10EnterpriseN'));
$requestBody->setLicense('License value');
$requestBody->setProductKey('Product Key value');
$result = $graphServiceClient->deviceManagement()->deviceConfigurations()->post($requestBody)->wait();
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
Import-Module Microsoft.Graph.DeviceManagement
$params = @{
"@odata.type" = "#microsoft.graph.editionUpgradeConfiguration"
description = "Description value"
displayName = "Display Name value"
version = 7
licenseType = "licenseFile"
targetEdition = "windows10EnterpriseN"
license = "License value"
productKey = "Product Key value"
}
New-MgDeviceManagementDeviceConfiguration -BodyParameter $params
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
from msgraph import GraphServiceClient
from msgraph.generated.models.edition_upgrade_configuration import EditionUpgradeConfiguration
from msgraph.generated.models.edition_upgrade_license_type import EditionUpgradeLicenseType
from msgraph.generated.models.windows10_edition_type import Windows10EditionType
graph_client = GraphServiceClient(credentials, scopes)
request_body = EditionUpgradeConfiguration(
odata_type = "#microsoft.graph.editionUpgradeConfiguration",
description = "Description value",
display_name = "Display Name value",
version = 7,
license_type = EditionUpgradeLicenseType.LicenseFile,
target_edition = Windows10EditionType.Windows10EnterpriseN,
license = "License value",
product_key = "Product Key value",
)
result = await graph_client.device_management.device_configurations.post(request_body)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
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: 483
{
"@odata.type": "#microsoft.graph.editionUpgradeConfiguration",
"id": "f39fc471-c471-f39f-71c4-9ff371c49ff3",
"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,
"licenseType": "licenseFile",
"targetEdition": "windows10EnterpriseN",
"license": "License value",
"productKey": "Product Key value"
}