title | description | author | localization_priority | ms.subservice | doc_type |
---|---|---|---|---|---|
Update windows10TeamGeneralConfiguration |
Update the properties of a windows10TeamGeneralConfiguration object. |
jaiprakashmb |
Normal |
intune |
apiPageType |
Namespace: microsoft.graph
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Update the properties of a windows10TeamGeneralConfiguration object.
[!INCLUDE national-cloud-support]
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | DeviceManagementConfiguration.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | DeviceManagementConfiguration.ReadWrite.All |
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
Header | Value |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Accept | application/json |
In the request body, supply a JSON representation for the windows10TeamGeneralConfiguration object.
The following table shows the properties that are required when you create the windows10TeamGeneralConfiguration.
Property | Type | Description |
---|---|---|
id | String | Key of the entity. Inherited from deviceConfiguration |
lastModifiedDateTime | DateTimeOffset | DateTime the object was last modified. Inherited from deviceConfiguration |
createdDateTime | DateTimeOffset | DateTime the object was created. Inherited from deviceConfiguration |
description | String | Admin provided description of the Device Configuration. Inherited from deviceConfiguration |
displayName | String | Admin provided name of the device configuration. Inherited from deviceConfiguration |
version | Int32 | Version of the device configuration. Inherited from deviceConfiguration |
azureOperationalInsightsBlockTelemetry | Boolean | Indicates whether or not to Block Azure Operational Insights. |
azureOperationalInsightsWorkspaceId | String | The Azure Operational Insights workspace id. |
azureOperationalInsightsWorkspaceKey | String | The Azure Operational Insights Workspace key. |
connectAppBlockAutoLaunch | Boolean | Specifies whether to automatically launch the Connect app whenever a projection is initiated. |
maintenanceWindowBlocked | Boolean | Indicates whether or not to Block setting a maintenance window for device updates. |
maintenanceWindowDurationInHours | Int32 | Maintenance window duration for device updates. Valid values 0 to 5 |
maintenanceWindowStartTime | TimeOfDay | Maintenance window start time for device updates. |
miracastChannel | miracastChannel | The channel. Possible values are: userDefined , one , two , three , four , five , six , seven , eight , nine , ten , eleven , thirtySix , forty , fortyFour , fortyEight , oneHundredFortyNine , oneHundredFiftyThree , oneHundredFiftySeven , oneHundredSixtyOne , oneHundredSixtyFive . |
miracastBlocked | Boolean | Indicates whether or not to Block wireless projection. |
miracastRequirePin | Boolean | Indicates whether or not to require a pin for wireless projection. |
settingsBlockMyMeetingsAndFiles | Boolean | Specifies whether to disable the "My meetings and files" feature in the Start menu, which shows the signed-in user's meetings and files from Office 365. |
settingsBlockSessionResume | Boolean | Specifies whether to allow the ability to resume a session when the session times out. |
settingsBlockSigninSuggestions | Boolean | Specifies whether to disable auto-populating of the sign-in dialog with invitees from scheduled meetings. |
settingsDefaultVolume | Int32 | Specifies the default volume value for a new session. Permitted values are 0-100. The default is 45. Valid values 0 to 100 |
settingsScreenTimeoutInMinutes | Int32 | Specifies the number of minutes until the Hub screen turns off. |
settingsSessionTimeoutInMinutes | Int32 | Specifies the number of minutes until the session times out. |
settingsSleepTimeoutInMinutes | Int32 | Specifies the number of minutes until the Hub enters sleep mode. |
welcomeScreenBlockAutomaticWakeUp | Boolean | Indicates whether or not to Block the welcome screen from waking up automatically when someone enters the room. |
welcomeScreenBackgroundImageUrl | String | The welcome screen background image URL. The URL must use the HTTPS protocol and return a PNG image. |
welcomeScreenMeetingInformation | welcomeScreenMeetingInformation | The welcome screen meeting information shown. Possible values are: userDefined , showOrganizerAndTimeOnly , showOrganizerAndTimeAndSubject . |
If successful, this method returns a 200 OK
response code and an updated windows10TeamGeneralConfiguration object in the response body.
Here is an example of the request.
PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1150
{
"@odata.type": "#microsoft.graph.windows10TeamGeneralConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"azureOperationalInsightsBlockTelemetry": true,
"azureOperationalInsightsWorkspaceId": "Azure Operational Insights Workspace Id value",
"azureOperationalInsightsWorkspaceKey": "Azure Operational Insights Workspace Key value",
"connectAppBlockAutoLaunch": true,
"maintenanceWindowBlocked": true,
"maintenanceWindowDurationInHours": 0,
"maintenanceWindowStartTime": "11:59:09.3130000",
"miracastChannel": "one",
"miracastBlocked": true,
"miracastRequirePin": true,
"settingsBlockMyMeetingsAndFiles": true,
"settingsBlockSessionResume": true,
"settingsBlockSigninSuggestions": true,
"settingsDefaultVolume": 5,
"settingsScreenTimeoutInMinutes": 14,
"settingsSessionTimeoutInMinutes": 15,
"settingsSleepTimeoutInMinutes": 13,
"welcomeScreenBlockAutomaticWakeUp": true,
"welcomeScreenBackgroundImageUrl": "https://example.com/welcomeScreenBackgroundImageUrl/",
"welcomeScreenMeetingInformation": "showOrganizerAndTimeOnly"
}
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1322
{
"@odata.type": "#microsoft.graph.windows10TeamGeneralConfiguration",
"id": "0c94aa20-aa20-0c94-20aa-940c20aa940c",
"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,
"azureOperationalInsightsBlockTelemetry": true,
"azureOperationalInsightsWorkspaceId": "Azure Operational Insights Workspace Id value",
"azureOperationalInsightsWorkspaceKey": "Azure Operational Insights Workspace Key value",
"connectAppBlockAutoLaunch": true,
"maintenanceWindowBlocked": true,
"maintenanceWindowDurationInHours": 0,
"maintenanceWindowStartTime": "11:59:09.3130000",
"miracastChannel": "one",
"miracastBlocked": true,
"miracastRequirePin": true,
"settingsBlockMyMeetingsAndFiles": true,
"settingsBlockSessionResume": true,
"settingsBlockSigninSuggestions": true,
"settingsDefaultVolume": 5,
"settingsScreenTimeoutInMinutes": 14,
"settingsSessionTimeoutInMinutes": 15,
"settingsSleepTimeoutInMinutes": 13,
"welcomeScreenBlockAutomaticWakeUp": true,
"welcomeScreenBackgroundImageUrl": "https://example.com/welcomeScreenBackgroundImageUrl/",
"welcomeScreenMeetingInformation": "showOrganizerAndTimeOnly"
}