Criar macOSSoftwareUpdateConfigurationCreate macOSSoftwareUpdateConfiguration

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Crie um novo objeto macOSSoftwareUpdateConfiguration.Create a new macOSSoftwareUpdateConfiguration object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitação HTTPHTTP Request

POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, fornece uma representação JSON para o objeto macOSSoftwareUpdateConfiguration.In the request body, supply a JSON representation for the macOSSoftwareUpdateConfiguration object.

A tabela a seguir mostra as propriedades que são necessárias ao criar o macOSSoftwareUpdateConfiguration.The following table shows the properties that are required when you create the macOSSoftwareUpdateConfiguration.

PropriedadeProperty TipoType DescriçãoDescription
idid Cadeia de caracteresString Chave da entidade.Key of the entity. Herdada de deviceConfigurationInherited from deviceConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset DateTime da última modificação do objeto.DateTime the object was last modified. Herdada de deviceConfigurationInherited from deviceConfiguration
roleScopeTagIdsroleScopeTagIds Coleção de cadeias de caracteresString collection Lista de marcas de escopo para esta instância entity.List of Scope Tags for this Entity instance. Herdada de deviceConfigurationInherited from deviceConfiguration
supportsScopeTagssupportsScopeTags BooleanoBoolean Indica se a Configuração de Dispositivo subjacente dá suporte ou não à atribuição de marcas de escopo.Indicates whether or not the underlying Device Configuration supports the assignment of scope tags. A atribuição à propriedade ScopeTags não é permitida quando esse valor é falso e as entidades não estarão visíveis para usuários com escopo.Assigning to the ScopeTags property is not allowed when this value is false and entities will not be visible to scoped users. Isso ocorre para políticas herdadas criadas no Silverlight e podem ser resolvidas excluindo e recriando a política no Portal do Azure.This occurs for Legacy policies created in Silverlight and can be resolved by deleting and recreating the policy in the Azure Portal. Essa propriedade é somente leitura.This property is read-only. Herdada de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleOsEditiondeviceManagementApplicabilityRuleOsEdition deviceManagementApplicabilityRuleOsEditiondeviceManagementApplicabilityRuleOsEdition A aplicabilidade da edição do sistema operacional para esta Política.The OS edition applicability for this Policy. Herdada de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleOsVersiondeviceManagementApplicabilityRuleOsVersion deviceManagementApplicabilityRuleOsVersiondeviceManagementApplicabilityRuleOsVersion A regra de aplicabilidade da versão do sistema operacional para esta Política.The OS version applicability rule for this Policy. Herdada de deviceConfigurationInherited from deviceConfiguration
deviceManagementApplicabilityRuleDeviceModedeviceManagementApplicabilityRuleDeviceMode deviceManagementApplicabilityRuleDeviceModedeviceManagementApplicabilityRuleDeviceMode A regra de aplicabilidade do modo de dispositivo para esta Política.The device mode applicability rule for this Policy. Herdada de deviceConfigurationInherited from deviceConfiguration
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset DateTime em que o objeto foi criado.DateTime the object was created. Herdada de deviceConfigurationInherited from deviceConfiguration
descriçãodescription Cadeia de caracteresString O administrador forneceu a descrição da Configuração do dispositivo.Admin provided description of the Device Configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
displayNamedisplayName Cadeia de caracteresString O administrador forneceu o nome da Configuração do dispositivo.Admin provided name of the device configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
versãoversion Int32Int32 Versão da configuração do dispositivo.Version of the device configuration. Herdada de deviceConfigurationInherited from deviceConfiguration
criticalUpdateBehaviorcriticalUpdateBehavior macOSSoftwareUpdateBehaviormacOSSoftwareUpdateBehavior Atualize o comportamento para atualizações críticas.Update behavior for critical updates. Os valores possíveis são: notConfigured e default.Possible values are: notConfigured, default.
configDataUpdateBehaviorconfigDataUpdateBehavior macOSSoftwareUpdateBehaviormacOSSoftwareUpdateBehavior Atualizar comportamento para atualizações de arquivo de dados de configuração.Update behavior for configuration data file updates. Os valores possíveis são: notConfigured e default.Possible values are: notConfigured, default.
firmwareUpdateBehaviorfirmwareUpdateBehavior macOSSoftwareUpdateBehaviormacOSSoftwareUpdateBehavior Comportamento de atualização para atualizações de firmware.Update behavior for firmware updates. Os valores possíveis são: notConfigured e default.Possible values are: notConfigured, default.
allOtherUpdateBehaviorallOtherUpdateBehavior macOSSoftwareUpdateBehaviormacOSSoftwareUpdateBehavior Atualize o comportamento de todas as outras atualizações.Update behavior for all other updates. Os valores possíveis são: notConfigured e default.Possible values are: notConfigured, default.
updateScheduleTypeupdateScheduleType macOSSoftwareUpdateScheduleTypemacOSSoftwareUpdateScheduleType Atualizar tipo de agendamento.Update schedule type. Os valores possíveis são: alwaysUpdate, updateDuringTimeWindows, updateOutsideOfTimeWindows.Possible values are: alwaysUpdate, updateDuringTimeWindows, updateOutsideOfTimeWindows.
customUpdateTimeWindowscustomUpdateTimeWindows Coleção customUpdateTimeWindowcustomUpdateTimeWindow collection Janelas de tempo personalizadas quando as atualizações serão permitidas ou bloqueadas.Custom Time windows when updates will be allowed or blocked. Essa coleção pode conter no máximo 20 elementos.This collection can contain a maximum of 20 elements.
updateTimeWindowUtcOffsetInMinutesupdateTimeWindowUtcOffsetInMinutes Int32Int32 Minutos indicando deslocamento UTC para cada janela de tempo de atualizaçãoMinutes indicating UTC offset for each update time window

RespostaResponse

Se tiver êxito, este método retornará um código de resposta e um 201 Created objeto macOSSoftwareUpdateConfiguration no corpo da resposta.If successful, this method returns a 201 Created response code and a macOSSoftwareUpdateConfiguration object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 1542

{
  "@odata.type": "#microsoft.graph.macOSSoftwareUpdateConfiguration",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "criticalUpdateBehavior": "default",
  "configDataUpdateBehavior": "default",
  "firmwareUpdateBehavior": "default",
  "allOtherUpdateBehavior": "default",
  "updateScheduleType": "updateDuringTimeWindows",
  "customUpdateTimeWindows": [
    {
      "@odata.type": "microsoft.graph.customUpdateTimeWindow",
      "startDay": "monday",
      "endDay": "monday",
      "startTime": "12:03:30.2730000",
      "endTime": "12:03:02.3740000"
    }
  ],
  "updateTimeWindowUtcOffsetInMinutes": 2
}

RespostaResponse

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.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 201 Created
Content-Type: application/json
Content-Length: 1714

{
  "@odata.type": "#microsoft.graph.macOSSoftwareUpdateConfiguration",
  "id": "b8e467ac-67ac-b8e4-ac67-e4b8ac67e4b8",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "criticalUpdateBehavior": "default",
  "configDataUpdateBehavior": "default",
  "firmwareUpdateBehavior": "default",
  "allOtherUpdateBehavior": "default",
  "updateScheduleType": "updateDuringTimeWindows",
  "customUpdateTimeWindows": [
    {
      "@odata.type": "microsoft.graph.customUpdateTimeWindow",
      "startDay": "monday",
      "endDay": "monday",
      "startTime": "12:03:30.2730000",
      "endTime": "12:03:02.3740000"
    }
  ],
  "updateTimeWindowUtcOffsetInMinutes": 2
}