Criar iosUpdateConfiguration
Artigo
12/04/2023
11 colaboradores
Comentários
Neste artigo
Namespace: microsoft.graph
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Cria um novo objeto iosUpdateConfiguration .
Essa API está disponível nas seguintes implantações nacionais de nuvem .
Serviço global
Governo dos EUA L4
GOVERNO DOS EUA 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ç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 iosUpdateConfiguration.
A tabela a seguir mostra as propriedades obrigatórias ao criar iosUpdateConfiguration.
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. Herdada de deviceConfiguration
activeHoursStart
TimeOfDay
Início do Horário Ativo (o horário ativo significa a janela de tempo quando a instalação das atualizações não deve acontecer)
activeHoursEnd
TimeOfDay
Término do Horário Ativo (o horário ativo significa a janela de tempo quando a instalação das atualizações não deve acontecer)
scheduledInstallDays
coleção dayOfWeek
Dias na semana para os quais o horário ativo está configurado. Essa coleção pode conter um máximo de 7 elementos. Os valores possíveis são: sunday
, monday
, tuesday
, wednesday
, thursday
, friday
, saturday
.
utcTimeOffsetInMinutes
Int32
Deslocamento do horário UTC indicado em minutos
Resposta
Se tiver êxito, este método retornará o código de resposta 201 Created
e um objeto iosUpdateConfiguration 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: 325
{
"@odata.type": "#microsoft.graph.iosUpdateConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"activeHoursStart": "12:00:05.5020000",
"activeHoursEnd": "11:59:00.8990000",
"scheduledInstallDays": [
"monday"
],
"utcTimeOffsetInMinutes": 6
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new IosUpdateConfiguration
{
OdataType = "#microsoft.graph.iosUpdateConfiguration",
Description = "Description value",
DisplayName = "Display Name value",
Version = 7,
ActiveHoursStart = new Time(DateTime.Parse("12:00:05.5020000")),
ActiveHoursEnd = new Time(DateTime.Parse("11:59:00.8990000")),
ScheduledInstallDays = new List<DayOfWeekObject?>
{
DayOfWeekObject.Monday,
},
UtcTimeOffsetInMinutes = 6,
};
// 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);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK .
mgc device-management device-configurations create --body '{\
"@odata.type": "#microsoft.graph.iosUpdateConfiguration",\
"description": "Description value",\
"displayName": "Display Name value",\
"version": 7,\
"activeHoursStart": "12:00:05.5020000",\
"activeHoursEnd": "11:59:00.8990000",\
"scheduledInstallDays": [\
"monday"\
],\
"utcTimeOffsetInMinutes": 6\
}\
'
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK .
// 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)
activeHoursStart := 12:00:05.5020000
requestBody.SetActiveHoursStart(&activeHoursStart)
activeHoursEnd := 11:59:00.8990000
requestBody.SetActiveHoursEnd(&activeHoursEnd)
scheduledInstallDays := []graphmodels.DayOfWeekable {
dayOfWeek := graphmodels.MONDAY_DAYOFWEEK
requestBody.SetDayOfWeek(&dayOfWeek)
}
requestBody.SetScheduledInstallDays(scheduledInstallDays)
utcTimeOffsetInMinutes := int32(6)
requestBody.SetUtcTimeOffsetInMinutes(&utcTimeOffsetInMinutes)
// 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)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK .
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
IosUpdateConfiguration deviceConfiguration = new IosUpdateConfiguration();
deviceConfiguration.setOdataType("#microsoft.graph.iosUpdateConfiguration");
deviceConfiguration.setDescription("Description value");
deviceConfiguration.setDisplayName("Display Name value");
deviceConfiguration.setVersion(7);
LocalTime activeHoursStart = LocalTime.parse("12:00:05.5020000");
deviceConfiguration.setActiveHoursStart(activeHoursStart);
LocalTime activeHoursEnd = LocalTime.parse("11:59:00.8990000");
deviceConfiguration.setActiveHoursEnd(activeHoursEnd);
LinkedList<DayOfWeek> scheduledInstallDays = new LinkedList<DayOfWeek>();
scheduledInstallDays.add(DayOfWeek.Monday);
deviceConfiguration.setScheduledInstallDays(scheduledInstallDays);
deviceConfiguration.setUtcTimeOffsetInMinutes(6);
DeviceConfiguration result = graphClient.deviceManagement().deviceConfigurations().post(deviceConfiguration);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK .
const options = {
authProvider,
};
const client = Client.init(options);
const deviceConfiguration = {
'@odata.type': '#microsoft.graph.iosUpdateConfiguration',
description: 'Description value',
displayName: 'Display Name value',
version: 7,
activeHoursStart: '12:00:05.5020000',
activeHoursEnd: '11:59:00.8990000',
scheduledInstallDays: [
'monday'
],
utcTimeOffsetInMinutes: 6
};
await client.api('/deviceManagement/deviceConfigurations')
.post(deviceConfiguration);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK .
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\IosUpdateConfiguration;
use Microsoft\Kiota\Abstractions\Types\Time;
use Microsoft\Graph\Generated\Models\DayOfWeek;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new IosUpdateConfiguration();
$requestBody->setOdataType('#microsoft.graph.iosUpdateConfiguration');
$requestBody->setDescription('Description value');
$requestBody->setDisplayName('Display Name value');
$requestBody->setVersion(7);
$requestBody->setActiveHoursStart(new Time('12:00:05.5020000'));
$requestBody->setActiveHoursEnd(new Time('11:59:00.8990000'));
$requestBody->setScheduledInstallDays([new DayOfWeek('monday'), ]);
$requestBody->setUtcTimeOffsetInMinutes(6);
$result = $graphServiceClient->deviceManagement()->deviceConfigurations()->post($requestBody)->wait();
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK .
Import-Module Microsoft.Graph.DeviceManagement
$params = @{
"@odata.type" = "#microsoft.graph.iosUpdateConfiguration"
description = "Description value"
displayName = "Display Name value"
version = 7
activeHoursStart = "12:00:05.5020000"
activeHoursEnd = "11:59:00.8990000"
scheduledInstallDays = @(
"monday"
)
utcTimeOffsetInMinutes =
}
New-MgDeviceManagementDeviceConfiguration -BodyParameter $params
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK .
from msgraph import GraphServiceClient
from msgraph.generated.models.ios_update_configuration import IosUpdateConfiguration
from msgraph.generated.models.day_of_week import DayOfWeek
graph_client = GraphServiceClient(credentials, scopes)
request_body = IosUpdateConfiguration(
odata_type = "#microsoft.graph.iosUpdateConfiguration",
description = "Description value",
display_name = "Display Name value",
version = 7,
active_hours_start = "12:00:05.5020000",
active_hours_end = "11:59:00.8990000",
scheduled_install_days = [
DayOfWeek.Monday,
],
utc_time_offset_in_minutes = 6,
)
result = await graph_client.device_management.device_configurations.post(request_body)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK .
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: 497
{
"@odata.type": "#microsoft.graph.iosUpdateConfiguration",
"id": "321aef09-ef09-321a-09ef-1a3209ef1a32",
"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,
"activeHoursStart": "12:00:05.5020000",
"activeHoursEnd": "11:59:00.8990000",
"scheduledInstallDays": [
"monday"
],
"utcTimeOffsetInMinutes": 6
}