Metode SetGateways dari kelas Win32_NetworkAdapterConfiguration
Metode kelasSetGatewaysWMI menentukan daftar gateway untuk perutean paket ke subnet yang berbeda dari subnet yang terhubung dengan adaptor jaringan.
Topik ini menggunakan sintaks Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.
Sintaks
uint32 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
Parameter
-
DefaultIPGateway [in]
-
Daftar alamat IP ke gateway tempat paket jaringan dirutekan.
-
GatewayCostMetric [in, opsional]
-
Menetapkan nilai yang berkisar antara 1 hingga 9999, yang digunakan untuk menghitung rute tercepat dan paling andal. Nilai parameter ini sesuai dengan nilai dalam parameter DefaultIPGateway . Nilai default untuk gateway adalah 1.
Mengembalikan nilai
Mengembalikan nilai 0 (nol) untuk penyelesaian yang berhasil ketika reboot tidak diperlukan, 1 (satu) untuk penyelesaian yang berhasil ketika boot ulang diperlukan, dan nilai lain jika ada kesalahan. Untuk informasi selengkapnya tentang kode kesalahan, lihat Konstanta Kesalahan WMI atau WbemErrorEnum. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.
-
Penyelesaian berhasil, tidak perlu boot ulang
-
0
-
Penyelesaian berhasil, reboot diperlukan
-
1
-
Metode tidak didukung pada platform ini
-
64
Metode tidak didukung ketika NIC berada dalam mode DHCP.
-
Kegagalan tidak diketahui
-
65
-
Subnet mask tidak valid
-
66
-
Terjadi kesalahan saat memproses Instans yang dikembalikan
-
67
-
Parameter input tidak valid
-
68
-
Lebih dari 5 gateway yang ditentukan
-
69
-
Alamat IP tidak valid
-
70
-
Alamat IP gateway tidak valid
-
71
-
Terjadi kesalahan saat mengakses Registri untuk informasi yang diminta
-
72
-
Nama domain tidak valid
-
73
-
Nama host tidak valid
-
74
-
Tidak ada server WINS primer/sekunder yang ditentukan
-
75
-
File tidak valid
-
76
-
Jalur sistem tidak valid
-
77
-
Salinan file gagal
-
78
-
Parameter keamanan tidak valid
-
79
-
Tidak dapat mengonfigurasi layanan TCP/IP
-
80
-
Tidak dapat mengonfigurasi layanan DHCP
-
81
-
Tidak dapat memperbarui sewa DHCP
-
82
-
Tidak dapat melepaskan sewa DHCP
-
83
-
IP tidak diaktifkan pada adaptor
-
84
-
IPX tidak diaktifkan pada adaptor
-
85
-
Kesalahan batas bingkai/nomor jaringan
-
86
-
Tipe bingkai tidak valid
-
87
-
Nomor jaringan tidak valid
-
88
-
Nomor jaringan duplikat
-
89
-
Parameter di luar batas
-
90
-
Akses ditolak
-
91
-
Kehabisan memori
-
92
-
Sudah ada
-
93
-
Jalur, file, atau objek tidak ditemukan
-
94
-
Tidak dapat memberi tahu layanan
-
95
-
Tidak dapat memberi tahu layanan DNS
-
96
-
Antarmuka tidak dapat dikonfigurasi
-
97
-
Tidak semua sewa DHCP dapat dirilis/diperpanjang
-
98
-
DHCP tidak diaktifkan pada adaptor
-
100
-
Lainnya
-
101 4294967295
Keterangan
Metode ini hanya berfungsi ketika Kartu Antarmuka Jaringan (NIC) berada dalam mode IP statis.
Untuk menghapus gateway, atur gateway Anda ke IP yang sama dengan yang Anda gunakan di EnableStatic.
Contoh
Sampel Ubah Gateway untuk VBScript Adapter Jaringan mengonfigurasi dua gateway untuk adaptor jaringan.
Sampel Tetapkan Alamat IP Statis VBScript mengatur alamat IP dan gateway komputer.
IP Statis lalu bergabung ke sampel PowerShell domain membantu dalam membangun kembali mesin.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|