Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Erstellen Sie ein neues cloudPcUserSetting-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
✅ |
✅ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
CloudPC.ReadWrite.All |
Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
CloudPC.ReadWrite.All |
Nicht verfügbar. |
HTTP-Anforderung
POST /deviceManagement/virtualEndpoint/userSettings
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des cloudPcUserSetting-Objekts an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von cloudPcUserSetting erforderlich sind.
| Eigenschaft |
Typ |
Beschreibung |
| crossRegionDisasterRecoverySetting |
cloudPcCrossRegionDisasterRecoverySetting |
Gibt regionsübergreifende Notfallwiederherstellungseinstellungen für den Cloud-PC des Benutzers an. |
| displayName |
Zeichenfolge |
Der Einstellungsname, wie er auf der Benutzeroberfläche angezeigt wird. |
| lastModifiedDateTime |
DateTimeOffset |
Das Datum und die Uhrzeit der letzten Änderung der Einstellung. Der Zeitstempeltyp stellt die Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. |
| localAdminEnabled |
Boolean |
Um die Option lokaler Administrator zu aktivieren, ändern Sie diese Einstellung in true. |
| provisioningSourceType |
cloudPcProvisioningSourceType |
Gibt die Bereitstellungsquelle des Cloud-PCs an, der für einen Endbenutzer vorbereitet ist. Die möglichen Werte sind: image, snapshot, unknownFutureValue. Der Standardwert ist image. Wenn diese Eigenschaft nicht auf festgelegt oder auf nullfestgelegt ist, ist ihre Funktionalität mit der Festlegung auf imageidentisch. |
| restorePointSetting |
cloudPcRestorePointSetting |
Definiert, wie häufig ein Wiederherstellungspunkt für die bereitgestellten Cloud-PCs von Benutzern erstellt wird (d. h. ein Momentaufnahme wird) erstellt wird (Der Standardwert ist 12 Stunden), und ob der Benutzer seine eigenen Cloud-PCs auf einer Sicherung wiederherstellen darf, die zu einem bestimmten Zeitpunkt erstellt wurde. |
| selfServiceEnabled (veraltet) |
Boolean |
Um die Self-Service-Option zu aktivieren, ändern Sie diese Einstellung in true. Die selfServiceEnabled-Eigenschaft ist veraltet und gibt am 1. Dezember 2023 keine Daten mehr zurück. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein cloudPcUserSetting-Objekt im Antworttext zurück.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/userSettings
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudPcUserSetting",
"displayName": "Example",
"selfServiceEnabled": false,
"localAdminEnabled": true,
"crossRegionDisasterRecoverySetting": {
"crossRegionDisasterRecoveryEnabled": false,
"maintainCrossRegionRestorePointEnabled": true,
"disasterRecoveryNetworkSetting": {
"regionName": "westus",
"regionGroup": "usEast"
},
"disasterRecoveryType": "premium",
"userInitiatedDisasterRecoveryAllowed": true
},
"provisioningSourceType": "image",
"restorePointSetting": {
"frequencyInHours": 16,
"frequencyType": "sixteenHours",
"userRestoreEnabled": true
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new CloudPcUserSetting
{
OdataType = "#microsoft.graph.cloudPcUserSetting",
DisplayName = "Example",
SelfServiceEnabled = false,
LocalAdminEnabled = true,
CrossRegionDisasterRecoverySetting = new CloudPcCrossRegionDisasterRecoverySetting
{
CrossRegionDisasterRecoveryEnabled = false,
MaintainCrossRegionRestorePointEnabled = true,
DisasterRecoveryNetworkSetting = new CloudPcDisasterRecoveryNetworkSetting
{
AdditionalData = new Dictionary<string, object>
{
{
"regionName" , "westus"
},
{
"regionGroup" , "usEast"
},
},
},
DisasterRecoveryType = CloudPcDisasterRecoveryType.Premium,
UserInitiatedDisasterRecoveryAllowed = true,
},
ProvisioningSourceType = CloudPcProvisioningSourceType.Image,
RestorePointSetting = new CloudPcRestorePointSetting
{
FrequencyInHours = 16,
FrequencyType = CloudPcRestorePointFrequencyType.SixteenHours,
UserRestoreEnabled = true,
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.VirtualEndpoint.UserSettings.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewCloudPcUserSetting()
displayName := "Example"
requestBody.SetDisplayName(&displayName)
selfServiceEnabled := false
requestBody.SetSelfServiceEnabled(&selfServiceEnabled)
localAdminEnabled := true
requestBody.SetLocalAdminEnabled(&localAdminEnabled)
crossRegionDisasterRecoverySetting := graphmodels.NewCloudPcCrossRegionDisasterRecoverySetting()
crossRegionDisasterRecoveryEnabled := false
crossRegionDisasterRecoverySetting.SetCrossRegionDisasterRecoveryEnabled(&crossRegionDisasterRecoveryEnabled)
maintainCrossRegionRestorePointEnabled := true
crossRegionDisasterRecoverySetting.SetMaintainCrossRegionRestorePointEnabled(&maintainCrossRegionRestorePointEnabled)
disasterRecoveryNetworkSetting := graphmodels.NewCloudPcDisasterRecoveryNetworkSetting()
additionalData := map[string]interface{}{
"regionName" : "westus",
"regionGroup" : "usEast",
}
disasterRecoveryNetworkSetting.SetAdditionalData(additionalData)
crossRegionDisasterRecoverySetting.SetDisasterRecoveryNetworkSetting(disasterRecoveryNetworkSetting)
disasterRecoveryType := graphmodels.PREMIUM_CLOUDPCDISASTERRECOVERYTYPE
crossRegionDisasterRecoverySetting.SetDisasterRecoveryType(&disasterRecoveryType)
userInitiatedDisasterRecoveryAllowed := true
crossRegionDisasterRecoverySetting.SetUserInitiatedDisasterRecoveryAllowed(&userInitiatedDisasterRecoveryAllowed)
requestBody.SetCrossRegionDisasterRecoverySetting(crossRegionDisasterRecoverySetting)
provisioningSourceType := graphmodels.IMAGE_CLOUDPCPROVISIONINGSOURCETYPE
requestBody.SetProvisioningSourceType(&provisioningSourceType)
restorePointSetting := graphmodels.NewCloudPcRestorePointSetting()
frequencyInHours := int32(16)
restorePointSetting.SetFrequencyInHours(&frequencyInHours)
frequencyType := graphmodels.SIXTEENHOURS_CLOUDPCRESTOREPOINTFREQUENCYTYPE
restorePointSetting.SetFrequencyType(&frequencyType)
userRestoreEnabled := true
restorePointSetting.SetUserRestoreEnabled(&userRestoreEnabled)
requestBody.SetRestorePointSetting(restorePointSetting)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
userSettings, err := graphClient.DeviceManagement().VirtualEndpoint().UserSettings().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
CloudPcUserSetting cloudPcUserSetting = new CloudPcUserSetting();
cloudPcUserSetting.setOdataType("#microsoft.graph.cloudPcUserSetting");
cloudPcUserSetting.setDisplayName("Example");
cloudPcUserSetting.setSelfServiceEnabled(false);
cloudPcUserSetting.setLocalAdminEnabled(true);
CloudPcCrossRegionDisasterRecoverySetting crossRegionDisasterRecoverySetting = new CloudPcCrossRegionDisasterRecoverySetting();
crossRegionDisasterRecoverySetting.setCrossRegionDisasterRecoveryEnabled(false);
crossRegionDisasterRecoverySetting.setMaintainCrossRegionRestorePointEnabled(true);
CloudPcDisasterRecoveryNetworkSetting disasterRecoveryNetworkSetting = new CloudPcDisasterRecoveryNetworkSetting();
HashMap<String, Object> additionalData = new HashMap<String, Object>();
additionalData.put("regionName", "westus");
additionalData.put("regionGroup", "usEast");
disasterRecoveryNetworkSetting.setAdditionalData(additionalData);
crossRegionDisasterRecoverySetting.setDisasterRecoveryNetworkSetting(disasterRecoveryNetworkSetting);
crossRegionDisasterRecoverySetting.setDisasterRecoveryType(CloudPcDisasterRecoveryType.Premium);
crossRegionDisasterRecoverySetting.setUserInitiatedDisasterRecoveryAllowed(true);
cloudPcUserSetting.setCrossRegionDisasterRecoverySetting(crossRegionDisasterRecoverySetting);
cloudPcUserSetting.setProvisioningSourceType(CloudPcProvisioningSourceType.Image);
CloudPcRestorePointSetting restorePointSetting = new CloudPcRestorePointSetting();
restorePointSetting.setFrequencyInHours(16);
restorePointSetting.setFrequencyType(CloudPcRestorePointFrequencyType.SixteenHours);
restorePointSetting.setUserRestoreEnabled(true);
cloudPcUserSetting.setRestorePointSetting(restorePointSetting);
CloudPcUserSetting result = graphClient.deviceManagement().virtualEndpoint().userSettings().post(cloudPcUserSetting);
const options = {
authProvider,
};
const client = Client.init(options);
const cloudPcUserSetting = {
'@odata.type': '#microsoft.graph.cloudPcUserSetting',
displayName: 'Example',
selfServiceEnabled: false,
localAdminEnabled: true,
crossRegionDisasterRecoverySetting: {
crossRegionDisasterRecoveryEnabled: false,
maintainCrossRegionRestorePointEnabled: true,
disasterRecoveryNetworkSetting: {
regionName: 'westus',
regionGroup: 'usEast'
},
disasterRecoveryType: 'premium',
userInitiatedDisasterRecoveryAllowed: true
},
provisioningSourceType: 'image',
restorePointSetting: {
frequencyInHours: 16,
frequencyType: 'sixteenHours',
userRestoreEnabled: true
}
};
await client.api('/deviceManagement/virtualEndpoint/userSettings')
.version('beta')
.post(cloudPcUserSetting);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\CloudPcUserSetting;
use Microsoft\Graph\Beta\Generated\Models\CloudPcCrossRegionDisasterRecoverySetting;
use Microsoft\Graph\Beta\Generated\Models\CloudPcDisasterRecoveryNetworkSetting;
use Microsoft\Graph\Beta\Generated\Models\CloudPcDisasterRecoveryType;
use Microsoft\Graph\Beta\Generated\Models\CloudPcProvisioningSourceType;
use Microsoft\Graph\Beta\Generated\Models\CloudPcRestorePointSetting;
use Microsoft\Graph\Beta\Generated\Models\CloudPcRestorePointFrequencyType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new CloudPcUserSetting();
$requestBody->setOdataType('#microsoft.graph.cloudPcUserSetting');
$requestBody->setDisplayName('Example');
$requestBody->setSelfServiceEnabled(false);
$requestBody->setLocalAdminEnabled(true);
$crossRegionDisasterRecoverySetting = new CloudPcCrossRegionDisasterRecoverySetting();
$crossRegionDisasterRecoverySetting->setCrossRegionDisasterRecoveryEnabled(false);
$crossRegionDisasterRecoverySetting->setMaintainCrossRegionRestorePointEnabled(true);
$crossRegionDisasterRecoverySettingDisasterRecoveryNetworkSetting = new CloudPcDisasterRecoveryNetworkSetting();
$additionalData = [
'regionName' => 'westus',
'regionGroup' => 'usEast',
];
$crossRegionDisasterRecoverySettingDisasterRecoveryNetworkSetting->setAdditionalData($additionalData);
$crossRegionDisasterRecoverySetting->setDisasterRecoveryNetworkSetting($crossRegionDisasterRecoverySettingDisasterRecoveryNetworkSetting);
$crossRegionDisasterRecoverySetting->setDisasterRecoveryType(new CloudPcDisasterRecoveryType('premium'));
$crossRegionDisasterRecoverySetting->setUserInitiatedDisasterRecoveryAllowed(true);
$requestBody->setCrossRegionDisasterRecoverySetting($crossRegionDisasterRecoverySetting);
$requestBody->setProvisioningSourceType(new CloudPcProvisioningSourceType('image'));
$restorePointSetting = new CloudPcRestorePointSetting();
$restorePointSetting->setFrequencyInHours(16);
$restorePointSetting->setFrequencyType(new CloudPcRestorePointFrequencyType('sixteenHours'));
$restorePointSetting->setUserRestoreEnabled(true);
$requestBody->setRestorePointSetting($restorePointSetting);
$result = $graphServiceClient->deviceManagement()->virtualEndpoint()->userSettings()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.DeviceManagement.Administration
$params = @{
"@odata.type" = "#microsoft.graph.cloudPcUserSetting"
displayName = "Example"
selfServiceEnabled = $false
localAdminEnabled = $true
crossRegionDisasterRecoverySetting = @{
crossRegionDisasterRecoveryEnabled = $false
maintainCrossRegionRestorePointEnabled = $true
disasterRecoveryNetworkSetting = @{
regionName = "westus"
regionGroup = "usEast"
}
disasterRecoveryType = "premium"
userInitiatedDisasterRecoveryAllowed = $true
}
provisioningSourceType = "image"
restorePointSetting = @{
frequencyInHours = 16
frequencyType = "sixteenHours"
userRestoreEnabled = $true
}
}
New-MgBetaDeviceManagementVirtualEndpointUserSetting -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.cloud_pc_user_setting import CloudPcUserSetting
from msgraph_beta.generated.models.cloud_pc_cross_region_disaster_recovery_setting import CloudPcCrossRegionDisasterRecoverySetting
from msgraph_beta.generated.models.cloud_pc_disaster_recovery_network_setting import CloudPcDisasterRecoveryNetworkSetting
from msgraph_beta.generated.models.cloud_pc_disaster_recovery_type import CloudPcDisasterRecoveryType
from msgraph_beta.generated.models.cloud_pc_provisioning_source_type import CloudPcProvisioningSourceType
from msgraph_beta.generated.models.cloud_pc_restore_point_setting import CloudPcRestorePointSetting
from msgraph_beta.generated.models.cloud_pc_restore_point_frequency_type import CloudPcRestorePointFrequencyType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = CloudPcUserSetting(
odata_type = "#microsoft.graph.cloudPcUserSetting",
display_name = "Example",
self_service_enabled = False,
local_admin_enabled = True,
cross_region_disaster_recovery_setting = CloudPcCrossRegionDisasterRecoverySetting(
cross_region_disaster_recovery_enabled = False,
maintain_cross_region_restore_point_enabled = True,
disaster_recovery_network_setting = CloudPcDisasterRecoveryNetworkSetting(
additional_data = {
"region_name" : "westus",
"region_group" : "usEast",
}
),
disaster_recovery_type = CloudPcDisasterRecoveryType.Premium,
user_initiated_disaster_recovery_allowed = True,
),
provisioning_source_type = CloudPcProvisioningSourceType.Image,
restore_point_setting = CloudPcRestorePointSetting(
frequency_in_hours = 16,
frequency_type = CloudPcRestorePointFrequencyType.SixteenHours,
user_restore_enabled = True,
),
)
result = await graph_client.device_management.virtual_endpoint.user_settings.post(request_body)
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudPcUserSetting",
"id": "556092f8-92f8-5560-f892-6055f8926055",
"displayName": "Example",
"selfServiceEnabled": false,
"localAdminEnabled": true,
"crossRegionDisasterRecoverySetting": {
"crossRegionDisasterRecoveryEnabled": false,
"maintainCrossRegionRestorePointEnabled": true,
"disasterRecoveryNetworkSetting": {
"regionName": "westus",
"regionGroup": "usEast"
},
"disasterRecoveryType": "premium",
"userInitiatedDisasterRecoveryAllowed": true
},
"restorePointSetting": {
"frequencyInHours": 16,
"frequencyType": "sixteenHours",
"userRestoreEnabled": true
},
"provisioningSourceType": "image",
"lastModifiedDateTime": "2021-02-01T10:29:57Z"
}