Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Criar um novo objeto windows10TeamGeneralConfiguration.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
| Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
|---|---|
| Delegado (conta corporativa ou de estudante) | DeviceManagementConfiguration.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. |
| Application | DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
POST /deviceManagement/deviceConfigurations
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Aceitar | application/json |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON do objeto windows10TeamGeneralConfiguration.
A tabela a seguir mostra as propriedades obrigatórias ao criar windows10TeamGeneralConfiguration.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | String | Chave da entidade. Herdada de deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | DateTime da última modificação do objeto. Herdada de deviceConfiguration |
| createdDateTime | DateTimeOffset | DateTime em que o objeto foi criado. Herdada de deviceConfiguration |
| description | String | O administrador forneceu a descrição da Configuração do dispositivo. Herdada de deviceConfiguration |
| displayName | String | O administrador forneceu o nome da Configuração do dispositivo. Herdada de deviceConfiguration |
| versão | Int32 | Versão da configuração do dispositivo. Herdado de deviceConfiguration |
| azureOperationalInsightsBlockTelemetry | Boolean | Indica se os Insights Operacionais do Azure devem ou não ser bloqueados. |
| azureOperationalInsightsWorkspaceId | Cadeia de caracteres | A ID do espaço de trabalho dos Insights Operacionais do Azure. |
| azureOperationalInsightsWorkspaceKey | Cadeia de caracteres | A chave do espaço de trabalho dos Insights Operacionais do Azure. |
| connectAppBlockAutoLaunch | Boolean | Especifica se o aplicativo Connect deverá ser iniciado automaticamente sempre que uma projeção for iniciada. |
| maintenanceWindowBlocked | Boolean | Indica se a configuração de uma janela de manutenção para atualizações do dispositivo deverá ou não ser bloqueada. |
| maintenanceWindowDurationInHours | Int32 | Duração da janela de manutenção para atualizações do dispositivo. Valores válidos: 0 a 5 |
| maintenanceWindowStartTime | TimeOfDay | Hora de Início da janela de manutenção para atualizações do dispositivo. |
| miracastChannel | miracastChannel | O canal. Os valores possíveis são: userDefined, , onetwo, three, four, five, six, seven, eight, nine, , ten, eleven, thirtySix, , forty, fortyFour, , fortyEight, , oneHundredFortyNine, oneHundredFiftyThree, . oneHundredSixtyFiveoneHundredFiftySevenoneHundredSixtyOne |
| miracastBlocked | Boolean | Indica se a projeção sem fio deve ou não ser bloqueada. |
| miracastRequirePin | Boolean | Indica se será exigido um pin para a projeção sem fio. |
| settingsBlockMyMeetingsAndFiles | Boolean | Especifica se o recurso "Meus arquivos e reuniões" no menu Iniciar, que mostra as reuniões e arquivos do usuário conectado do Office 365, deverá ser desativado. |
| settingsBlockSessionResume | Boolean | Especifica se a capacidade de retomar uma sessão quando a sessão expirar será permitida. |
| settingsBlockSigninSuggestions | Boolean | Especifica se o preenchimento automático da caixa de diálogo de entrada com os convidados de reuniões agendadas será desativado. |
| settingsDefaultVolume | Int32 | Especifica o valor padrão de volume de uma nova sessão. Os valores permitidos ficam entre 0 e 100. O padrão é 45. Valores válidos de 0 a 100 |
| settingsScreenTimeoutInMinutes | Int32 | Especifica o número de minutos até a tela do Hub ser desligada. |
| settingsSessionTimeoutInMinutes | Int32 | Especifica o número de minutos até a sessão atingir o tempo limite. |
| settingsSleepTimeoutInMinutes | Int32 | Especifica o número de minutos até o Hub entrar no modo de suspensão. |
| welcomeScreenBlockAutomaticWakeUp | Boolean | Indica se a tela de boas-vindas será impedida de ser desativada automaticamente quando alguém entrar na sala. |
| welcomeScreenBackgroundImageUrl | Cadeia de caracteres | The welcome screen background image URL. A URL deve usar o protocolo HTTPS e retornar uma imagem PNG. |
| welcomeScreenMeetingInformation | welcomeScreenMeetingInformation | As informações da reunião mostradas na tela de boas-vindas. Os valores possíveis são: userDefined, showOrganizerAndTimeOnly, showOrganizerAndTimeAndSubject. |
Resposta
Se bem-sucedido, este método retornará um código de resposta 201 Created e um objeto windows10TeamGeneralConfiguration no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
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"
}
Resposta
Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.
HTTP/1.1 201 Created
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"
}