Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Cree un nuevo objeto cloudPcUserSetting .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global |
Gobierno de EE. UU. L4 |
Us Government L5 (DOD) |
China operada por 21Vianet |
| ✅ |
✅ |
✅ |
❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso |
Permisos con privilegios mínimos |
Permisos con privilegios más altos |
| Delegado (cuenta profesional o educativa) |
CloudPC. ReadWrite. All |
No disponible. |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
No admitida. |
| Aplicación |
CloudPC. ReadWrite. All |
No disponible. |
Solicitud HTTP
POST /deviceManagement/virtualEndpoint/userSettings
| Nombre |
Descripción |
| Authorization |
{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON del objeto cloudPcUserSetting .
En la tabla siguiente se enumeran las propiedades necesarias al crear cloudPcUserSetting.
| Propiedad |
Tipo |
Description |
| crossRegionDisasterRecoverySetting |
cloudPcCrossRegionDisasterRecoverySetting |
Indica la configuración de recuperación ante desastres entre regiones para el equipo en la nube del usuario. |
| displayName |
Cadena |
Nombre de la configuración tal como aparece en la interfaz de usuario. |
| lastModifiedDateTime |
DateTimeOffset |
La última fecha y hora en que se modificó la configuración. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| localAdminEnabled |
Booleano |
Para activar la opción de administrador local, cambie esta configuración a true. |
| provisioningSourceType |
cloudPcProvisioningSourceType |
Indica el origen de aprovisionamiento del equipo en la nube preparado para un usuario final. Los valores posibles son: image, snapshot, unknownFutureValue. El valor predeterminado es image. Si esta propiedad no está establecida o establecida en null, su funcionalidad es la misma que establecerla imageen . |
| restorePointSetting |
cloudPcRestorePointSetting |
Define la frecuencia con la que se crea un punto de restauración (es decir, se toma una instantánea) para los equipos en la nube aprovisionados por los usuarios (el valor predeterminado es de 12 horas) y si el usuario puede restaurar sus propios equipos en la nube en una copia de seguridad realizada en un momento específico. |
| selfServiceEnabled (en desuso) |
Booleano |
Para activar la opción de autoservicio, cambie esta configuración a true. La propiedad selfServiceEnabled está en desuso y dejó de devolver datos el 1 de diciembre de 2023. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto cloudPcUserSetting en el cuerpo de la respuesta.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
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)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
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"
}