Create sharedPCConfiguration

Пространство имен: microsoft.graph

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Создание объекта sharedPCConfiguration.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	DeviceManagementConfiguration.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	DeviceManagementConfiguration.ReadWrite.All

HTTP-запрос

POST /deviceManagement/deviceConfigurations

Заголовки запроса

Заголовок	Значение
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept	application/json

Текст запроса

В тексте запроса добавьте представление объекта sharedPCConfiguration в формате JSON.

В приведенной ниже таблице показаны свойства, которые необходимо указывать при создании объекта sharedPCConfiguration.

Свойство	Тип	Описание
id	String	Ключ объекта. Наследуется от объекта deviceConfiguration.
lastModifiedDateTime	DateTimeOffset	Дата и время последнего изменения объекта. Наследуется от объекта deviceConfiguration.
createdDateTime	DateTimeOffset	Дата и время создания объекта. Наследуется от объекта deviceConfiguration.
description	String	Указанное администратором описание конфигурации устройства. Наследуется от объекта deviceConfiguration.
displayName	String	Указанное администратором имя конфигурации устройства. Наследуется от объекта deviceConfiguration.
version	Int32	Версия конфигурации устройства. Наследуется от объекта deviceConfiguration.
accountManagerPolicy	sharedPCAccountManagerPolicy	Определяет способ управления учетными записями на общем компьютере. Применяется, только если для параметра disableAccountManager установлено значение false.
allowedAccounts	sharedPCAllowedAccountType	Указывает тип учетных записей, которые можно использовать на общем компьютере. Возможные значения: guest, domain.
allowLocalStorage	Boolean	Определяет, разрешено ли на общем компьютере локальное хранилище.
disableAccountManager	Boolean	Отключает диспетчер учетных записей в режиме совместного использования компьютера.
disableEduPolicies	Boolean	Указывает, следует ли отключить стандартные политики среды совместного использования компьютера для образования. Для Windows 10 RS2 и более поздних версий эта политика будет применяться без установки значения True для параметра Enabled.
disablePowerPolicies	Boolean	Указывает, следует ли отключить стандартные политики электропитания для общего компьютера.
disableSignInOnResume	Boolean	Отключает обязательный вход в систему при выходе устройства из спящего режима.
enabled	Boolean	Включает режим общего компьютера и применяет политики совместного использования ПК.
idleTimeBeforeSleepInSeconds	Int32	Определяет длительность (в секундах) пребывания устройства в режиме бездействия перед переходом в спящий режим. Если задать значение 0, переход в спящий режим отключается.
kioskAppDisplayName	String	Задает текст для учетной записи, который отображается на экране входа в систему и используется для запуска приложения, определяемого с помощью свойства SetKioskAppUserModelId. Применяется, только если задано свойство KioskAppUserModelId.
kioskAppUserModelId	String	Определяет идентификатор пользовательской модели для приложения, используемого с ограниченным доступом.
maintenanceStartTime	TimeOfDay	Указывает ежедневное время начала обслуживания.

Ответ

В случае успешного выполнения этот метод возвращает код ответа 201 Created и объект sharedPCConfiguration в тексте ответа.

Пример

Запрос

Ниже приведен пример запроса.

HTTP

POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 860

{
  "@odata.type": "#microsoft.graph.sharedPCConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "accountManagerPolicy": {
    "@odata.type": "microsoft.graph.sharedPCAccountManagerPolicy",
    "accountDeletionPolicy": "diskSpaceThreshold",
    "cacheAccountsAboveDiskFreePercentage": 4,
    "inactiveThresholdDays": 5,
    "removeAccountsBelowDiskFreePercentage": 5
  },
  "allowedAccounts": "domain",
  "allowLocalStorage": true,
  "disableAccountManager": true,
  "disableEduPolicies": true,
  "disablePowerPolicies": true,
  "disableSignInOnResume": true,
  "enabled": true,
  "idleTimeBeforeSleepInSeconds": 12,
  "kioskAppDisplayName": "Kiosk App Display Name value",
  "kioskAppUserModelId": "Kiosk App User Model Id value",
  "maintenanceStartTime": "11:59:24.7240000"
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new SharedPCConfiguration
{
	OdataType = "#microsoft.graph.sharedPCConfiguration",
	Description = "Description value",
	DisplayName = "Display Name value",
	Version = 7,
	AccountManagerPolicy = new SharedPCAccountManagerPolicy
	{
		OdataType = "microsoft.graph.sharedPCAccountManagerPolicy",
		AccountDeletionPolicy = SharedPCAccountDeletionPolicyType.DiskSpaceThreshold,
		CacheAccountsAboveDiskFreePercentage = 4,
		InactiveThresholdDays = 5,
		RemoveAccountsBelowDiskFreePercentage = 5,
	},
	AllowedAccounts = SharedPCAllowedAccountType.Domain,
	AllowLocalStorage = true,
	DisableAccountManager = true,
	DisableEduPolicies = true,
	DisablePowerPolicies = true,
	DisableSignInOnResume = true,
	Enabled = true,
	IdleTimeBeforeSleepInSeconds = 12,
	KioskAppDisplayName = "Kiosk App Display Name value",
	KioskAppUserModelId = "Kiosk App User Model Id value",
	MaintenanceStartTime = new Time(DateTime.Parse("11:59:24.7240000")),
};

// 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);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

CLI

mgc device-management device-configurations create --body '{\
  "@odata.type": "#microsoft.graph.sharedPCConfiguration",\
  "description": "Description value",\
  "displayName": "Display Name value",\
  "version": 7,\
  "accountManagerPolicy": {\
    "@odata.type": "microsoft.graph.sharedPCAccountManagerPolicy",\
    "accountDeletionPolicy": "diskSpaceThreshold",\
    "cacheAccountsAboveDiskFreePercentage": 4,\
    "inactiveThresholdDays": 5,\
    "removeAccountsBelowDiskFreePercentage": 5\
  },\
  "allowedAccounts": "domain",\
  "allowLocalStorage": true,\
  "disableAccountManager": true,\
  "disableEduPolicies": true,\
  "disablePowerPolicies": true,\
  "disableSignInOnResume": true,\
  "enabled": true,\
  "idleTimeBeforeSleepInSeconds": 12,\
  "kioskAppDisplayName": "Kiosk App Display Name value",\
  "kioskAppUserModelId": "Kiosk App User Model Id value",\
  "maintenanceStartTime": "11:59:24.7240000"\
}\
'

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Go

// 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) 
accountManagerPolicy := graphmodels.NewSharedPCAccountManagerPolicy()
accountDeletionPolicy := graphmodels.DISKSPACETHRESHOLD_SHAREDPCACCOUNTDELETIONPOLICYTYPE 
accountManagerPolicy.SetAccountDeletionPolicy(&accountDeletionPolicy) 
cacheAccountsAboveDiskFreePercentage := int32(4)
accountManagerPolicy.SetCacheAccountsAboveDiskFreePercentage(&cacheAccountsAboveDiskFreePercentage) 
inactiveThresholdDays := int32(5)
accountManagerPolicy.SetInactiveThresholdDays(&inactiveThresholdDays) 
removeAccountsBelowDiskFreePercentage := int32(5)
accountManagerPolicy.SetRemoveAccountsBelowDiskFreePercentage(&removeAccountsBelowDiskFreePercentage) 
requestBody.SetAccountManagerPolicy(accountManagerPolicy)
allowedAccounts := graphmodels.DOMAIN_SHAREDPCALLOWEDACCOUNTTYPE 
requestBody.SetAllowedAccounts(&allowedAccounts) 
allowLocalStorage := true
requestBody.SetAllowLocalStorage(&allowLocalStorage) 
disableAccountManager := true
requestBody.SetDisableAccountManager(&disableAccountManager) 
disableEduPolicies := true
requestBody.SetDisableEduPolicies(&disableEduPolicies) 
disablePowerPolicies := true
requestBody.SetDisablePowerPolicies(&disablePowerPolicies) 
disableSignInOnResume := true
requestBody.SetDisableSignInOnResume(&disableSignInOnResume) 
enabled := true
requestBody.SetEnabled(&enabled) 
idleTimeBeforeSleepInSeconds := int32(12)
requestBody.SetIdleTimeBeforeSleepInSeconds(&idleTimeBeforeSleepInSeconds) 
kioskAppDisplayName := "Kiosk App Display Name value"
requestBody.SetKioskAppDisplayName(&kioskAppDisplayName) 
kioskAppUserModelId := "Kiosk App User Model Id value"
requestBody.SetKioskAppUserModelId(&kioskAppUserModelId) 
maintenanceStartTime := 11:59:24.7240000
requestBody.SetMaintenanceStartTime(&maintenanceStartTime) 

// 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)

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

SharedPCConfiguration deviceConfiguration = new SharedPCConfiguration();
deviceConfiguration.setOdataType("#microsoft.graph.sharedPCConfiguration");
deviceConfiguration.setDescription("Description value");
deviceConfiguration.setDisplayName("Display Name value");
deviceConfiguration.setVersion(7);
SharedPCAccountManagerPolicy accountManagerPolicy = new SharedPCAccountManagerPolicy();
accountManagerPolicy.setOdataType("microsoft.graph.sharedPCAccountManagerPolicy");
accountManagerPolicy.setAccountDeletionPolicy(SharedPCAccountDeletionPolicyType.DiskSpaceThreshold);
accountManagerPolicy.setCacheAccountsAboveDiskFreePercentage(4);
accountManagerPolicy.setInactiveThresholdDays(5);
accountManagerPolicy.setRemoveAccountsBelowDiskFreePercentage(5);
deviceConfiguration.setAccountManagerPolicy(accountManagerPolicy);
deviceConfiguration.setAllowedAccounts(EnumSet.of(SharedPCAllowedAccountType.Domain));
deviceConfiguration.setAllowLocalStorage(true);
deviceConfiguration.setDisableAccountManager(true);
deviceConfiguration.setDisableEduPolicies(true);
deviceConfiguration.setDisablePowerPolicies(true);
deviceConfiguration.setDisableSignInOnResume(true);
deviceConfiguration.setEnabled(true);
deviceConfiguration.setIdleTimeBeforeSleepInSeconds(12);
deviceConfiguration.setKioskAppDisplayName("Kiosk App Display Name value");
deviceConfiguration.setKioskAppUserModelId("Kiosk App User Model Id value");
LocalTime maintenanceStartTime = LocalTime.parse("11:59:24.7240000");
deviceConfiguration.setMaintenanceStartTime(maintenanceStartTime);
DeviceConfiguration result = graphClient.deviceManagement().deviceConfigurations().post(deviceConfiguration);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const deviceConfiguration = {
  '@odata.type': '#microsoft.graph.sharedPCConfiguration',
  description: 'Description value',
  displayName: 'Display Name value',
  version: 7,
  accountManagerPolicy: {
    '@odata.type': 'microsoft.graph.sharedPCAccountManagerPolicy',
    accountDeletionPolicy: 'diskSpaceThreshold',
    cacheAccountsAboveDiskFreePercentage: 4,
    inactiveThresholdDays: 5,
    removeAccountsBelowDiskFreePercentage: 5
  },
  allowedAccounts: 'domain',
  allowLocalStorage: true,
  disableAccountManager: true,
  disableEduPolicies: true,
  disablePowerPolicies: true,
  disableSignInOnResume: true,
  enabled: true,
  idleTimeBeforeSleepInSeconds: 12,
  kioskAppDisplayName: 'Kiosk App Display Name value',
  kioskAppUserModelId: 'Kiosk App User Model Id value',
  maintenanceStartTime: '11:59:24.7240000'
};

await client.api('/deviceManagement/deviceConfigurations')
	.post(deviceConfiguration);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\SharedPCConfiguration;
use Microsoft\Graph\Generated\Models\SharedPCAccountManagerPolicy;
use Microsoft\Graph\Generated\Models\SharedPCAccountDeletionPolicyType;
use Microsoft\Graph\Generated\Models\SharedPCAllowedAccountType;
use Microsoft\Kiota\Abstractions\Types\Time;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new SharedPCConfiguration();
$requestBody->setOdataType('#microsoft.graph.sharedPCConfiguration');
$requestBody->setDescription('Description value');
$requestBody->setDisplayName('Display Name value');
$requestBody->setVersion(7);
$accountManagerPolicy = new SharedPCAccountManagerPolicy();
$accountManagerPolicy->setOdataType('microsoft.graph.sharedPCAccountManagerPolicy');
$accountManagerPolicy->setAccountDeletionPolicy(new SharedPCAccountDeletionPolicyType('diskSpaceThreshold'));
$accountManagerPolicy->setCacheAccountsAboveDiskFreePercentage(4);
$accountManagerPolicy->setInactiveThresholdDays(5);
$accountManagerPolicy->setRemoveAccountsBelowDiskFreePercentage(5);
$requestBody->setAccountManagerPolicy($accountManagerPolicy);
$requestBody->setAllowedAccounts(new SharedPCAllowedAccountType('domain'));
$requestBody->setAllowLocalStorage(true);
$requestBody->setDisableAccountManager(true);
$requestBody->setDisableEduPolicies(true);
$requestBody->setDisablePowerPolicies(true);
$requestBody->setDisableSignInOnResume(true);
$requestBody->setEnabled(true);
$requestBody->setIdleTimeBeforeSleepInSeconds(12);
$requestBody->setKioskAppDisplayName('Kiosk App Display Name value');
$requestBody->setKioskAppUserModelId('Kiosk App User Model Id value');
$requestBody->setMaintenanceStartTime(new Time('11:59:24.7240000'));

$result = $graphServiceClient->deviceManagement()->deviceConfigurations()->post($requestBody)->wait();

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

PowerShell

Import-Module Microsoft.Graph.DeviceManagement

$params = @{
	"@odata.type" = "#microsoft.graph.sharedPCConfiguration"
	description = "Description value"
	displayName = "Display Name value"
	version = 7
	accountManagerPolicy = @{
		"@odata.type" = "microsoft.graph.sharedPCAccountManagerPolicy"
		accountDeletionPolicy = "diskSpaceThreshold"
		cacheAccountsAboveDiskFreePercentage = 
		inactiveThresholdDays = 
		removeAccountsBelowDiskFreePercentage = 
	}
	allowedAccounts = "domain"
	allowLocalStorage = $true
	disableAccountManager = $true
	disableEduPolicies = $true
	disablePowerPolicies = $true
	disableSignInOnResume = $true
	enabled = $true
	idleTimeBeforeSleepInSeconds = 
	kioskAppDisplayName = "Kiosk App Display Name value"
	kioskAppUserModelId = "Kiosk App User Model Id value"
	maintenanceStartTime = "11:59:24.7240000"
}

New-MgDeviceManagementDeviceConfiguration -BodyParameter $params

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.shared_p_c_configuration import SharedPCConfiguration
from msgraph.generated.models.shared_p_c_account_manager_policy import SharedPCAccountManagerPolicy
from msgraph.generated.models.shared_p_c_account_deletion_policy_type import SharedPCAccountDeletionPolicyType
from msgraph.generated.models.shared_p_c_allowed_account_type import SharedPCAllowedAccountType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = SharedPCConfiguration(
	odata_type = "#microsoft.graph.sharedPCConfiguration",
	description = "Description value",
	display_name = "Display Name value",
	version = 7,
	account_manager_policy = SharedPCAccountManagerPolicy(
		odata_type = "microsoft.graph.sharedPCAccountManagerPolicy",
		account_deletion_policy = SharedPCAccountDeletionPolicyType.DiskSpaceThreshold,
		cache_accounts_above_disk_free_percentage = 4,
		inactive_threshold_days = 5,
		remove_accounts_below_disk_free_percentage = 5,
	),
	allowed_accounts = SharedPCAllowedAccountType.Domain,
	allow_local_storage = True,
	disable_account_manager = True,
	disable_edu_policies = True,
	disable_power_policies = True,
	disable_sign_in_on_resume = True,
	enabled = True,
	idle_time_before_sleep_in_seconds = 12,
	kiosk_app_display_name = "Kiosk App Display Name value",
	kiosk_app_user_model_id = "Kiosk App User Model Id value",
	maintenance_start_time = "11:59:24.7240000",
)

result = await graph_client.device_management.device_configurations.post(request_body)

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1032

{
  "@odata.type": "#microsoft.graph.sharedPCConfiguration",
  "id": "5206be3b-be3b-5206-3bbe-06523bbe0652",
  "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,
  "accountManagerPolicy": {
    "@odata.type": "microsoft.graph.sharedPCAccountManagerPolicy",
    "accountDeletionPolicy": "diskSpaceThreshold",
    "cacheAccountsAboveDiskFreePercentage": 4,
    "inactiveThresholdDays": 5,
    "removeAccountsBelowDiskFreePercentage": 5
  },
  "allowedAccounts": "domain",
  "allowLocalStorage": true,
  "disableAccountManager": true,
  "disableEduPolicies": true,
  "disablePowerPolicies": true,
  "disableSignInOnResume": true,
  "enabled": true,
  "idleTimeBeforeSleepInSeconds": 12,
  "kioskAppDisplayName": "Kiosk App Display Name value",
  "kioskAppUserModelId": "Kiosk App User Model Id value",
  "maintenanceStartTime": "11:59:24.7240000"
}