创建 cloudPcUserSetting
命名空间：microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
创建新的 cloudPcUserSetting 对象。
权限
要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。
| 权限类型 |
权限（从最低特权到最高特权） |
| 委派（工作或学校帐户） |
CloudPC.ReadWrite.All |
| 委派（个人 Microsoft 帐户） |
不支持。 |
| 应用程序 |
CloudPC.ReadWrite.All |
HTTP 请求
POST /deviceManagement/virtualEndpoint/userSettings
| 名称 |
说明 |
| Authorization |
Bearer {token}。必需。 |
| Content-Type |
application/json. Required. |
请求正文
在请求正文中，提供 cloudPcUserSetting 对象的 JSON 表示形式。
下表显示创建 cloudPcUserSetting 时所需的属性。
| 属性 |
类型 |
说明 |
| displayName |
String |
显示在 UI 中的设置名称。 |
| localAdminEnabled |
Boolean |
若要启用本地管理员选项，将此设置更改为 True。 |
| selfServiceEnabled |
Boolean |
若要启用自助服务选项，将此设置更改为 True。 |
| restorePointSetting |
cloudPcRestorePointSetting |
定义创建还原点的频率 (即，为用户预配的云电脑拍摄) 快照 (默认值为 12 小时) ，以及是否允许用户将自己的云电脑还原到特定时间点的备份。 |
| lastModifiedDateTime |
DateTimeOffset |
上次修改设置的日期和时间。 时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 如下所示："2014-01-01T00：00：00Z"。 |
响应
如果成功，此方法在响应 201 Created 正文中返回 响应代码和 cloudPcUserSetting 对象。
示例
请求
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/userSettings
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudPcUserSetting",
"displayName": "Example",
"selfServiceEnabled": false,
"localAdminEnabled": true,
"restorePointSetting": {
"frequencyInHours": 16,
"userRestoreEnabled": true
}
}
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var cloudPcUserSetting = new CloudPcUserSetting
{
DisplayName = "Example",
SelfServiceEnabled = false,
LocalAdminEnabled = true,
RestorePointSetting = new CloudPcRestorePointSetting
{
FrequencyInHours = 16,
UserRestoreEnabled = true
}
};
await graphClient.DeviceManagement.VirtualEndpoint.UserSettings
.Request()
.AddAsync(cloudPcUserSetting);
const options = {
authProvider,
};
const client = Client.init(options);
const cloudPcUserSetting = {
'@odata.type': '#microsoft.graph.cloudPcUserSetting',
displayName: 'Example',
selfServiceEnabled: false,
localAdminEnabled: true,
restorePointSetting: {
frequencyInHours: 16,
userRestoreEnabled: true
}
};
await client.api('/deviceManagement/virtualEndpoint/userSettings')
.version('beta')
.post(cloudPcUserSetting);
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/deviceManagement/virtualEndpoint/userSettings"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
MSGraphCloudPcUserSetting *cloudPcUserSetting = [[MSGraphCloudPcUserSetting alloc] init];
[cloudPcUserSetting setDisplayName:@"Example"];
[cloudPcUserSetting setSelfServiceEnabled: false];
[cloudPcUserSetting setLocalAdminEnabled: true];
MSGraphCloudPcRestorePointSetting *restorePointSetting = [[MSGraphCloudPcRestorePointSetting alloc] init];
[restorePointSetting setFrequencyInHours: 16];
[restorePointSetting setUserRestoreEnabled: true];
[cloudPcUserSetting setRestorePointSetting:restorePointSetting];
NSError *error;
NSData *cloudPcUserSettingData = [cloudPcUserSetting getSerializedDataWithError:&error];
[urlRequest setHTTPBody:cloudPcUserSettingData];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
CloudPcUserSetting cloudPcUserSetting = new CloudPcUserSetting();
cloudPcUserSetting.displayName = "Example";
cloudPcUserSetting.selfServiceEnabled = false;
cloudPcUserSetting.localAdminEnabled = true;
CloudPcRestorePointSetting restorePointSetting = new CloudPcRestorePointSetting();
restorePointSetting.frequencyInHours = 16;
restorePointSetting.userRestoreEnabled = true;
cloudPcUserSetting.restorePointSetting = restorePointSetting;
graphClient.deviceManagement().virtualEndpoint().userSettings()
.buildRequest()
.post(cloudPcUserSetting);
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
requestBody := msgraphsdk.NewCloudPcUserSetting()
displayName := "Example"
requestBody.SetDisplayName(&displayName)
selfServiceEnabled := false
requestBody.SetSelfServiceEnabled(&selfServiceEnabled)
localAdminEnabled := true
requestBody.SetLocalAdminEnabled(&localAdminEnabled)
restorePointSetting := msgraphsdk.NewCloudPcRestorePointSetting()
requestBody.SetRestorePointSetting(restorePointSetting)
frequencyInHours := int32(16)
restorePointSetting.SetFrequencyInHours(&frequencyInHours)
userRestoreEnabled := true
restorePointSetting.SetUserRestoreEnabled(&userRestoreEnabled)
requestBody.SetAdditionalData(map[string]interface{}{
"@odata.type": "#microsoft.graph.cloudPcUserSetting",
}
result, err := graphClient.DeviceManagement().VirtualEndpoint().UserSettings().Post(requestBody)
Import-Module Microsoft.Graph.DeviceManagement.Administration
$params = @{
"@odata.type" = "#microsoft.graph.cloudPcUserSetting"
DisplayName = "Example"
SelfServiceEnabled = $false
LocalAdminEnabled = $true
RestorePointSetting = @{
FrequencyInHours = 16
UserRestoreEnabled = $true
}
}
New-MgDeviceManagementVirtualEndpointUserSetting -BodyParameter $params
响应
注意： 为了提高可读性，可能缩短了此处显示的响应对象。
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,
"restorePointSetting": {
"frequencyInHours": 16,
"userRestoreEnabled": true
},
"lastModifiedDateTime": "2021-02-01T10:29:57Z"
}