Atualizar macOSEnterpriseWiFiConfigurationUpdate macOSEnterpriseWiFiConfiguration

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 o 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.

Atualiza as propriedades de um objeto macOSEnterpriseWiFiConfiguration .Update the properties of a macOSEnterpriseWiFiConfiguration 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 (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitação HTTPHTTP Request

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}

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, forneça uma representação JSON do objeto macOSEnterpriseWiFiConfiguration .In the request body, supply a JSON representation for the macOSEnterpriseWiFiConfiguration object.

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

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 de entidade.List of Scope Tags for this Entity instance. Herdada de deviceConfigurationInherited from deviceConfiguration
supportsScopeTagssupportsScopeTags BoolianoBoolean Indica se a configuração de dispositivo subjacente é ou não compatível com a 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 é false e as entidades não serão visíveis aos 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 pode ser resolvido 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 essa 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 essa 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
descriptiondescription StringString 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
NetworkNamenetworkName Cadeia de caracteresString Nome da rede herdado de macOSWiFiConfigurationNetwork Name Inherited from macOSWiFiConfiguration
SSIDssid Cadeia de caracteresString Este é o nome da rede Wi-Fi que é transmitida para todos os dispositivos.This is the name of the Wi-Fi network that is broadcast to all devices. Herdado de macOSWiFiConfigurationInherited from macOSWiFiConfiguration
connectAutomaticallyconnectAutomatically BoolianoBoolean Conectar automaticamente quando esta rede estiver no intervalo.Connect automatically when this network is in range. A definição dessa opção como true ignorará o prompt do usuário e conectará automaticamente o dispositivo à rede Wi-Fi.Setting this to true will skip the user prompt and automatically connect the device to Wi-Fi network. Herdado de macOSWiFiConfigurationInherited from macOSWiFiConfiguration
connectWhenNetworkNameIsHiddenconnectWhenNetworkNameIsHidden BoolianoBoolean Conecte-se quando a rede não estiver transmitindo seu nome (SSID).Connect when the network is not broadcasting its name (SSID). Quando definido como true, esse perfil força o dispositivo a se conectar a uma rede que não transmite seu SSID para todos os dispositivos.When set to true, this profile forces the device to connect to a network that doesn't broadcast its SSID to all devices. Herdado de macOSWiFiConfigurationInherited from macOSWiFiConfiguration
àwiFiSecurityType àwiFiSecurityType Indica se o ponto de extremidade Wi-Fi usa um tipo de segurança baseado em EAP.Indicates whether Wi-Fi endpoint uses an EAP based security type. Herdado de macOSWiFiConfiguration.Inherited from macOSWiFiConfiguration. Os possíveis valores são: open, wpaPersonal, wpaEnterprise, wep, wpa2Personal, wpa2Enterprise.Possible values are: open, wpaPersonal, wpaEnterprise, wep, wpa2Personal, wpa2Enterprise.
proxySettingsproxySettings wiFiProxySettingwiFiProxySetting Tipo de proxy para esta conexão Wi-Fi herdada de macOSWiFiConfiguration.Proxy Type for this Wi-Fi connection Inherited from macOSWiFiConfiguration. Os valores possíveis são: none, manual, automatic.Possible values are: none, manual, automatic.
proxyManualAddressproxyManualAddress Cadeia de caracteresString Endereço IP ou nome de host DNS do servidor proxy quando a configuração manual estiver selecionada.IP Address or DNS hostname of the proxy server when manual configuration is selected. Herdado de macOSWiFiConfigurationInherited from macOSWiFiConfiguration
proxyManualPortproxyManualPort Int32Int32 Porta do servidor proxy quando a configuração manual estiver selecionada.Port of the proxy server when manual configuration is selected. Herdado de macOSWiFiConfigurationInherited from macOSWiFiConfiguration
proxyAutomaticConfigurationUrlproxyAutomaticConfigurationUrl Cadeia de caracteresString URL do script de configuração automática do servidor proxy quando a configuração automática estiver selecionada.URL of the proxy server automatic configuration script when automatic configuration is selected. Essa URL normalmente é o local do Arquivo PAC (configuração automática de proxy).This URL is typically the location of PAC (Proxy Auto Configuration) file. Herdado de macOSWiFiConfigurationInherited from macOSWiFiConfiguration
preSharedKeypreSharedKey Cadeia de caracteresString Esta é a chave pré-compartilhada para a rede Wi-Fi pessoal WPA.This is the pre-shared key for WPA Personal Wi-Fi network. Herdado de macOSWiFiConfigurationInherited from macOSWiFiConfiguration
eapTypeeapType eapTypeeapType EAP (protocolo de autenticação extensível).Extensible Authentication Protocol (EAP). Indica o tipo de protocolo EAP definido no ponto de extremidade Wi-Fi (roteador).Indicates the type of EAP protocol set on the Wi-Fi endpoint (router). Os possíveis valores são: eapTls, leap, eapSim, eapTtls, peap, eapFast.Possible values are: eapTls, leap, eapSim, eapTtls, peap, eapFast.
eapFastConfigurationeapFastConfiguration eapFastConfigurationeapFastConfiguration Opção de configuração EAP-FAST quando EAP-FAST for o tipo de EAP selecionado.EAP-FAST Configuration Option when EAP-FAST is the selected EAP Type. Os valores possíveis são: noProtectedAccessCredential, useProtectedAccessCredential, useProtectedAccessCredentialAndProvision, useProtectedAccessCredentialAndProvisionAnonymously.Possible values are: noProtectedAccessCredential, useProtectedAccessCredential, useProtectedAccessCredentialAndProvision, useProtectedAccessCredentialAndProvisionAnonymously.
trustedServerCertificateNamestrustedServerCertificateNames Coleção de cadeias de caracteresString collection Nomes de certificados de servidor confiáveis quando o tipo EAP é configurado como EAP-TLS/TTLS/FAST ou PEAP.Trusted server certificate names when EAP Type is configured to EAP-TLS/TTLS/FAST or PEAP. Este é o nome comum usado nos certificados emitidos pela autoridade de certificação (CA) confiável.This is the common name used in the certificates issued by your trusted certificate authority (CA). Se você fornecer essas informações, poderá ignorar a caixa de diálogo de confiança dinâmica exibida em dispositivos de usuários finais quando eles se conectam a esta rede Wi-Fi.If you provide this information, you can bypass the dynamic trust dialog that is displayed on end users devices when they connect to this Wi-Fi network.
authenticationMethodauthenticationMethod wiFiAuthenticationMethodwiFiAuthenticationMethod Método de autenticação quando o tipo EAP é configurado como PEAP ou EAP-TTLS.Authentication Method when EAP Type is configured to PEAP or EAP-TTLS. Os valores possíveis são: certificate, usernameAndPassword, derivedCredential.Possible values are: certificate, usernameAndPassword, derivedCredential.
innerAuthenticationProtocolForEapTtlsinnerAuthenticationProtocolForEapTtls nonEapAuthenticationMethodForEapTtlsTypenonEapAuthenticationMethodForEapTtlsType Método não EAP para autenticação (identidade interna) quando o tipo EAP é EAP-TTLS e AuthenticationMethod é username e password.Non-EAP Method for Authentication (Inner Identity) when EAP Type is EAP-TTLS and Authenticationmethod is Username and Password. Os valores possíveis são: unencryptedPassword, challengeHandshakeAuthenticationProtocol, microsoftChap, microsoftChapVersionTwo.Possible values are: unencryptedPassword, challengeHandshakeAuthenticationProtocol, microsoftChap, microsoftChapVersionTwo.
outerIdentityPrivacyTemporaryValueouterIdentityPrivacyTemporaryValue Cadeia de caracteresString Habilitar Privacidade de identidade (identidade externa) quando o tipo EAP é configurado como EAP-TTLS, EAP-FAST ou PEAP.Enable identity privacy (Outer Identity) when EAP Type is configured to EAP-TTLS, EAP-FAST or PEAP. Essa propriedade mascara os nomes de usernames com o texto inserido.This property masks usernames with the text you enter. Por exemplo, se você usar ' anônimo ', cada usuário que autenticar com essa conexão Wi-Fi usando seu nome de usuário real será exibido como ' anônimo '.For example, if you use 'anonymous', each user that authenticates with this Wi-Fi connection using their real username is displayed as 'anonymous'.

RespostaResponse

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

ExemploExample

SolicitaçãoRequest

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

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1858

{
  "@odata.type": "#microsoft.graph.macOSEnterpriseWiFiConfiguration",
  "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,
  "networkName": "Network Name value",
  "ssid": "Ssid value",
  "connectAutomatically": true,
  "connectWhenNetworkNameIsHidden": true,
  "wiFiSecurityType": "wpaPersonal",
  "proxySettings": "manual",
  "proxyManualAddress": "Proxy Manual Address value",
  "proxyManualPort": 15,
  "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
  "preSharedKey": "Pre Shared Key value",
  "eapType": "leap",
  "eapFastConfiguration": "useProtectedAccessCredential",
  "trustedServerCertificateNames": [
    "Trusted Server Certificate Names value"
  ],
  "authenticationMethod": "usernameAndPassword",
  "innerAuthenticationProtocolForEapTtls": "challengeHandshakeAuthenticationProtocol",
  "outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value"
}

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 200 OK
Content-Type: application/json
Content-Length: 2030

{
  "@odata.type": "#microsoft.graph.macOSEnterpriseWiFiConfiguration",
  "id": "7a6f9a2e-9a2e-7a6f-2e9a-6f7a2e9a6f7a",
  "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,
  "networkName": "Network Name value",
  "ssid": "Ssid value",
  "connectAutomatically": true,
  "connectWhenNetworkNameIsHidden": true,
  "wiFiSecurityType": "wpaPersonal",
  "proxySettings": "manual",
  "proxyManualAddress": "Proxy Manual Address value",
  "proxyManualPort": 15,
  "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
  "preSharedKey": "Pre Shared Key value",
  "eapType": "leap",
  "eapFastConfiguration": "useProtectedAccessCredential",
  "trustedServerCertificateNames": [
    "Trusted Server Certificate Names value"
  ],
  "authenticationMethod": "usernameAndPassword",
  "innerAuthenticationProtocolForEapTtls": "challengeHandshakeAuthenticationProtocol",
  "outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value"
}