Atualizar windowsWifiEnterpriseEAPConfiguration

Artigo
08/02/2024

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Atualize as propriedades de um objeto windowsWifiEnterpriseEAPConfiguration .

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

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

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 do pedido, forneça uma representação JSON para o objeto windowsWifiEnterpriseEAPConfiguration .

A tabela seguinte mostra as propriedades necessárias quando cria o windowsWifiEnterpriseEAPConfiguration.

Propriedade	Tipo	Descrição
id	String	Chave da entidade. Herdada de deviceConfiguration
lastModifiedDateTime	DateTimeOffset	DateTime da última modificação do objeto. Herdada de deviceConfiguration
roleScopeTagIds	Coleção String	Lista de Etiquetas de Âmbito para esta Instância de entidade. Herdada de deviceConfiguration
supportsScopeTags	Booliano	Indica se a Configuração do Dispositivo subjacente suporta ou não a atribuição de etiquetas de âmbito. A atribuição à propriedade ScopeTags não é permitida quando este valor é falso e as entidades não serão visíveis para os utilizadores no âmbito. Isto ocorre em políticas legadas criadas no Silverlight e pode ser resolvida ao eliminar e recriar a política no Portal do Azure. Essa propriedade é somente leitura. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	A aplicabilidade da edição do SO para esta Política. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	A regra de aplicabilidade da versão do SO para esta Política. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	A regra de aplicabilidade do modo de dispositivo para esta Política. 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
preSharedKey	Cadeia de caracteres	Esta é a chave pré-partilhada para a rede de Wi-Fi Pessoal do WPA. Herdado de windowsWifiConfiguration
wifiSecurityType	wiFiSecurityType	Especifique o Tipo de Segurança Wi-Fi. Herdado de windowsWifiConfiguration. Os possíveis valores são: `open`, `wpaPersonal`, `wpaEnterprise`, `wep`, `wpa2Personal`, `wpa2Enterprise`.
meteredConnectionLimit	meteredConnectionLimitType	Especifique o tipo de limite de ligação com tráfego limitado para a ligação wi-fi. Herdado de windowsWifiConfiguration. Os valores possíveis são: `unrestricted`, `fixed`, `variable`.
ssid	Cadeia de caracteres	Especifique o SSID da ligação wi-fi. Herdado de windowsWifiConfiguration
networkName	Cadeia de caracteres	Especifique o nome da configuração de rede. Herdado de windowsWifiConfiguration
connectAutomaticamente	Booliano	Especifique se a ligação wi-fi deve ligar-se automaticamente quando estiver dentro do intervalo. Herdado de windowsWifiConfiguration
connectToPreferredNetwork	Booliano	Especifique se a ligação wi-fi deve ligar-se a redes preferenciais quando já estiver ligada a esta. Requer que ConnectAutomaticamente seja verdadeiro. Herdado de windowsWifiConfiguration
connectWhenNetworkNameIsHidden	Booliano	Especifique se a ligação wi-fi deve ligar-se automaticamente mesmo quando o SSID não está a difundir. Herdado de windowsWifiConfiguration
proxySetting	wiFiProxySetting	Especifique a definição de proxy para Wi-Fi configuração Herdada do windowsWifiConfiguration. Os valores possíveis são: `none`, `manual`, `automatic`, `unknownFutureValue`.
proxyManualAddress	Cadeia de caracteres	Especifique o endereço IP para o servidor proxy. Herdado de windowsWifiConfiguration
proxyManualPort	Int32	Especifique a porta para o servidor proxy. Herdado de windowsWifiConfiguration
proxyAutomaticConfigurationUrl	Cadeia de caracteres	Especifique o URL para o script de configuração do servidor proxy. Herdado de windowsWifiConfiguration
forceFIPSCompliance	Booliano	Especifique se pretende forçar a conformidade FIPS. Herdado de windowsWifiConfiguration
networkSingleSignOn	networkSingleSignOnType	Especifique o tipo de início de sessão único de rede. Os valores possíveis são: `disabled`, `prelogon`, `postlogon`.
maximumAuthenticationTimeoutInSeconds	Int32	Especifique o tempo limite máximo de autenticação (em segundos). Intervalo válido: 1-120
userBasedVirtualLan	Booliano	Especificar se pretende alterar a LAN virtual utilizada pelo dispositivo com base nas credenciais do utilizador. Não é possível utilizar quando NetworkSingleSignOnType está definido como Desativado.
promptForAdditionalAuthenticationCredentials	Booliano	Especifique se a ligação wi-fi deve pedir credenciais de autenticação adicionais.
enablePairwiseMasterKeyCaching	Booliano	Especifique se a ligação wi-fi deve ativar a colocação em cache da chave mestra em pares.
maximumPairwiseMasterKeyCacheTimeInMinutes	Int32	Especifique o tempo máximo de cache da chave mestra em pares (em minutos). Intervalo válido: 5-1440
maximumNumberOfPairwiseMasterKeysInCache	Int32	Especifique o número máximo de chaves mestras em pares na cache. Intervalo válido: 1-255
enablePreAuthentication	Booliano	Especifique se a pré-autenticação deve ser ativada.
maximumPreAuthenticationAttempts	Int32	Especifique o máximo de tentativas de pré-autenticação. Intervalo válido: 1-16
eapType	eapType	Protocolo de Autenticação Extensível (EAP). Indica o tipo de protocolo EAP definido no ponto final Wi-Fi (router). Os valores possíveis são: `eapTls`, `leap`, `eapSim`, `eapTtls`, `peap`, `eapFast`, `teap`.
trustedServerCertificateNames	Coleção de cadeias de caracteres	Especifique nomes de certificados de servidor fidedignos.
authenticationMethod	wiFiAuthenticationMethod	Especifique o método de autenticação. Os valores possíveis são: `certificate`, `usernameAndPassword`, `derivedCredential`.
innerAuthenticationProtocolForEAPTTLS	nonEapAuthenticationMethodForEapTtlsType	Especifique o protocolo de autenticação interna para EAP TTLS. Os valores possíveis são: `unencryptedPassword`, `challengeHandshakeAuthenticationProtocol`, `microsoftChap`, `microsoftChapVersionTwo`.
outerIdentityPrivacyTemporaryValue	Cadeia de caracteres	Especifique a cadeia para substituir nomes de utilizador para privacidade ao utilizar OTLS EAP ou PEAP.
requireCryptographicBinding	Booliano	Especifique se pretende ativar o enlace criptográfico quando o tipo EAP é selecionado como PEAP.
performServerValidation	Booliano	Especifique se pretende ativar a verificação da identidade do servidor ao validar o certificado quando o tipo EAP está selecionado como PEAP.
disableUserPromptForServerValidation	Booliano	Especifique se pretende impedir que o utilizador seja solicitado a autorizar novos servidores para autoridades de certificação fidedignas quando o tipo de EAP é selecionado como PEAP.
authenticationPeriodInSeconds	Int32	Especifique o número de segundos para o cliente aguardar após uma tentativa de autenticação antes de falhar. Intervalo válido 1-3600.
authenticationRetryDelayPeriodInSeconds	Int32	Especifique o número de segundos entre uma autenticação falhada e a próxima tentativa de autenticação. Intervalo válido 1-3600.
eapolStartPeriodInSeconds	Int32	Especifique o número de segundos a aguardar antes de enviar uma mensagem de Início EAPOL (Extensible Authentication Protocol over LAN). Intervalo válido 1-3600.
maximumEAPOLStartMessages	Int32	Especificar o número máximo de mensagens de Início EAPOL (Extensible Authentication Protocol over LAN) a enviar antes de devolver a falha. Intervalo válido 1-100.
maximumAuthenticationFailures	Int32	Especifique as falhas de autenticação máximas permitidas para um conjunto de credenciais. Intervalo válido 1-100.
cacheCredentials	Booliano	Especifique se pretende colocar em cache as credenciais do utilizador no dispositivo para que os utilizadores não precisem de continuar a introduzi-las sempre que se ligam.
authenticationType	wifiAuthenticationType	Especifique se pretende autenticar o utilizador, o dispositivo ou utilizar a autenticação de convidado (nenhuma). Se estiver a utilizar a autenticação de certificado, certifique-se de que o tipo de certificado corresponde ao tipo de autenticação. Os valores possíveis são: `none`, `user`, `machine`, `machineOrUser`, `guest`.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto windowsWifiEnterpriseEAPConfiguration atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

{
  "@odata.type": "#microsoft.graph.windowsWifiEnterpriseEAPConfiguration",
  "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,
  "preSharedKey": "Pre Shared Key value",
  "wifiSecurityType": "wpaPersonal",
  "meteredConnectionLimit": "fixed",
  "ssid": "Ssid value",
  "networkName": "Network Name value",
  "connectAutomatically": true,
  "connectToPreferredNetwork": true,
  "connectWhenNetworkNameIsHidden": true,
  "proxySetting": "manual",
  "proxyManualAddress": "Proxy Manual Address value",
  "proxyManualPort": 15,
  "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
  "forceFIPSCompliance": true,
  "networkSingleSignOn": "prelogon",
  "maximumAuthenticationTimeoutInSeconds": 5,
  "userBasedVirtualLan": true,
  "promptForAdditionalAuthenticationCredentials": true,
  "enablePairwiseMasterKeyCaching": true,
  "maximumPairwiseMasterKeyCacheTimeInMinutes": 10,
  "maximumNumberOfPairwiseMasterKeysInCache": 8,
  "enablePreAuthentication": true,
  "maximumPreAuthenticationAttempts": 0,
  "eapType": "leap",
  "trustedServerCertificateNames": [
    "Trusted Server Certificate Names value"
  ],
  "authenticationMethod": "usernameAndPassword",
  "innerAuthenticationProtocolForEAPTTLS": "challengeHandshakeAuthenticationProtocol",
  "outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value",
  "requireCryptographicBinding": true,
  "performServerValidation": true,
  "disableUserPromptForServerValidation": true,
  "authenticationPeriodInSeconds": 13,
  "authenticationRetryDelayPeriodInSeconds": 7,
  "eapolStartPeriodInSeconds": 9,
  "maximumEAPOLStartMessages": 9,
  "maximumAuthenticationFailures": 13,
  "cacheCredentials": true,
  "authenticationType": "user"
}

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

{
  "@odata.type": "#microsoft.graph.windowsWifiEnterpriseEAPConfiguration",
  "id": "7e7183ac-83ac-7e71-ac83-717eac83717e",
  "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,
  "preSharedKey": "Pre Shared Key value",
  "wifiSecurityType": "wpaPersonal",
  "meteredConnectionLimit": "fixed",
  "ssid": "Ssid value",
  "networkName": "Network Name value",
  "connectAutomatically": true,
  "connectToPreferredNetwork": true,
  "connectWhenNetworkNameIsHidden": true,
  "proxySetting": "manual",
  "proxyManualAddress": "Proxy Manual Address value",
  "proxyManualPort": 15,
  "proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
  "forceFIPSCompliance": true,
  "networkSingleSignOn": "prelogon",
  "maximumAuthenticationTimeoutInSeconds": 5,
  "userBasedVirtualLan": true,
  "promptForAdditionalAuthenticationCredentials": true,
  "enablePairwiseMasterKeyCaching": true,
  "maximumPairwiseMasterKeyCacheTimeInMinutes": 10,
  "maximumNumberOfPairwiseMasterKeysInCache": 8,
  "enablePreAuthentication": true,
  "maximumPreAuthenticationAttempts": 0,
  "eapType": "leap",
  "trustedServerCertificateNames": [
    "Trusted Server Certificate Names value"
  ],
  "authenticationMethod": "usernameAndPassword",
  "innerAuthenticationProtocolForEAPTTLS": "challengeHandshakeAuthenticationProtocol",
  "outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value",
  "requireCryptographicBinding": true,
  "performServerValidation": true,
  "disableUserPromptForServerValidation": true,
  "authenticationPeriodInSeconds": 13,
  "authenticationRetryDelayPeriodInSeconds": 7,
  "eapolStartPeriodInSeconds": 9,
  "maximumEAPOLStartMessages": 9,
  "maximumAuthenticationFailures": 13,
  "cacheCredentials": true,
  "authenticationType": "user"
}

Compartilhar via

Atualizar windowsWifiEnterpriseEAPConfiguration

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplo

Solicitação

Resposta

Comentários

Recursos adicionais