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