Método EnableStatic da classe Win32_NetworkAdapterConfiguration
O método de classe WMIEnableStatic permite endereçamento TCP/IP estático para o adaptador de rede de destino. Como resultado, o DHCP para esse adaptador de rede está desabilitado.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 EnableStatic(
[in] string IPAddress[],
[in] string SubnetMask[]
);
Parâmetros
-
IPAddress [in]
-
Lista todos os endereços IP estáticos para o adaptador de rede atual.
Exemplo: 155.34.22.0.
-
SubnetMask [in]
-
Máscaras de sub-rede que complementam os valores no parâmetro IPAddress .
Exemplo: 255.255.0.0.
Valor retornado
Retorna um valor de 0 (zero) para uma conclusão bem-sucedida quando uma reinicialização não é necessária, 1 (um) para uma conclusão bem-sucedida quando uma reinicialização é necessária e qualquer outro número, se houver um erro. Para obter mais informações sobre códigos de erro, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.
-
Conclusão bem-sucedida, nenhuma reinicialização necessária
-
0
Conclusão bem-sucedida, nenhuma reinicialização necessária.
-
Conclusão bem-sucedida, reinicialização necessária
-
1
Conclusão bem-sucedida, reinicialização necessária.
-
Método sem suporte nesta plataforma
-
64
Método sem suporte nesta plataforma.
-
Falha desconhecida
-
65
Falha desconhecida.
-
Máscara de sub-rede inválida
-
66
Máscara de sub-rede inválida.
-
Ocorreu um erro ao processar uma Instância que foi retornada
-
67
Ocorreu um erro ao processar uma instância que foi retornada.
-
Parâmetro de entrada inválido
-
68
Parâmetro de entrada inválido.
-
Mais de 5 gateways especificados
-
69
Mais de cinco gateways especificados.
-
Endereço IP inválido
-
70
Endereço IP inválido.
-
Endereço IP do gateway inválido
-
71
Endereço IP do gateway inválido.
-
Ocorreu um erro ao acessar o Registro para obter as informações solicitadas
-
72
Ocorreu um erro ao acessar o registro para obter as informações solicitadas.
-
Nome de domínio inválido
-
73
Nome de domínio inválido.
-
Nome do host inválido
-
74
Nome do host inválido.
-
Nenhum servidor WINS primário/secundário definido
-
75
Nenhum servidor WINS primário ou secundário definido.
-
Arquivo inválido
-
76
Arquivo inválido.
-
Caminho do sistema inválido
-
77
Caminho do sistema inválido.
-
Falha na cópia do arquivo
-
78
Falha na cópia do arquivo.
-
Parâmetro de segurança inválido
-
79
Parâmetro de segurança inválido.
-
Não é possível configurar o serviço TCP/IP
-
80
Não é possível configurar o serviço TCP/IP.
-
Não é possível configurar o serviço DHCP
-
81
Não é possível configurar o serviço DHCP. Para obter mais informações, consulte a seção Comentários.
-
Não é possível renovar a concessão do DHCP
-
82
Não é possível renovar a concessão do DHCP.
-
Não é possível liberar a concessão do DHCP
-
83
Não é possível liberar a concessão do DHCP.
-
IP não habilitado no adaptador
-
84
IP não habilitado no adaptador.
-
IPX não habilitado no adaptador
-
85
IPX não habilitado no adaptador.
-
Erro de limites de número de quadro/rede
-
86
Erro de limites de quadro ou número de rede.
-
Tipo de quadro inválido
-
87
Tipo de quadro inválido.
-
Número de rede inválido
-
88
Número de rede inválido.
-
Número de rede duplicado
-
89
Número de rede duplicado.
-
Parâmetro fora dos limites
-
90
Parâmetro fora dos limites.
-
Acesso negado
-
91
Acesso negado.
-
Memória insuficiente
-
92
Sem memória.
-
Já existe
-
93
Já existe.
-
Caminho, arquivo ou objeto não encontrado
-
94
Caminho, arquivo ou objeto não encontrado.
-
Não é possível notificar o serviço
-
95
Não é possível notificar o serviço.
-
Não é possível notificar o serviço DNS
-
96
Não é possível notificar o serviço DNS.
-
Interface não configurável
-
97
Interface não configurável.
-
Nem todas as concessões dhcp poderiam ser liberadas/renovadas
-
98
Nem todas as concessões dhcp poderiam ser liberadas ou renovadas.
-
DHCP não habilitado no adaptador
-
100
O DHCP não está habilitado no adaptador.
-
2147786788
-
Bloqueio de gravação não habilitado. Para obter mais informações, consulte INetCfgLock::AcquireWriteLock.
-
Outros
-
101 4294967295
Comentários
Ao usar EnableStatic para alterar o endereço IP do computador remoto, enquanto estiver conectado por meio desse adaptador, você provavelmente perderá a conexão com o computador remoto e receberá uma mensagem de erro RPC não disponível. (no entanto, as configurações são alteradas). Para evitar esse cenário, considere alterar as configurações de Gateway e/ou DNS antes de definir o endereço IP do adaptador.
Ao usar EnableStatic para fornecer a um adaptador uma configuração de IP estático, a função retornará um "81 – Não é possível configurar o serviço DHCP" se o adaptador já estiver configurado com um endereço estático. No entanto, a função ainda é bem-sucedida na configuração com a nova operação.
Exemplos
O IP estático e, em seguida, ingressar em um exemplo de código do PowerShell de domínio, na Galeria do TechNet, usa EnableStatic para adicionar um IP estático a um computador local.
O exemplo de código Atribuir um endereço IP estático VBScript, na Galeria do TechNet, usa EnableStatic para definir o endereço IP de um computador.
O exemplo de VBScript a seguir demonstra como desabilitar o uso de DHCP em uma instância do Win32_NetworkAdapterConfiguration. Nesse caso, especificamos o adaptador com um Índice de 0. O índice correto deve ser selecionado de Win32_NetworkAdapter instâncias para outras interfaces.
Observação
Esse script só se aplica a sistemas baseados em NT Alterar as variáveis ipaddr e sub-rede abaixo para os valores que você deseja aplicar ao adaptador.
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")
ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")
RetVal = Adapter.EnableStatic(ipaddr,subnet)
if RetVal = 0 then
WScript.Echo "DHCP disabled, using static IP address"
else
WScript.Echo "DHCP disable failed"
end if
O exemplo de Perl a seguir demonstra como desabilitar o uso de DHCP em uma instância do Win32_NetworkAdapterConfiguration. Nesse caso, especificamos o adaptador com um Índice de 0. O índice correto deve ser selecionado de Win32_NetworkAdapter instâncias para outras interfaces.
Observação
Esse script só se aplica a sistemas baseados em NT Alterar as variáveis ipaddr e sub-rede abaixo para os valores que você deseja aplicar ao adaptador.
use strict;
use Win32::OLE;
my ($Adapter, @ipaddr, @subnet, $RetVal);
eval { $Adapter =
Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };
unless ($@)
{
push @ipaddr, "192.168.144.107";
push @subnet, "255.255.255.0";
$RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);
if ($RetVal == 0)
{
print "\nDHCP disabled, using static IP address\n";
}
else
{
print "\nDHCP disable failed\n";
}
}
else
{
print STDERR "\n", Win32::OLE->LastError, "\n";
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de