kelas Win32_NetworkConnection
Kelas WMI Win32_NetworkConnectionmewakili koneksi jaringan aktif di lingkungan berbasis Windows.
Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti dan metode dalam urutan alfabet, bukan urutan MOF.
Sintaks
[Dynamic, Provider("CIMWin32"), UUID("{8502C4CD-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkConnection : CIM_LogicalElement
{
string Caption;
string Description;
datetime InstallDate;
string Status;
uint32 AccessMask;
string Comment;
string ConnectionState;
string ConnectionType;
string DisplayType;
string LocalName;
string Name;
boolean Persistent;
string ProviderName;
string RemoteName;
string RemotePath;
string ResourceType;
string UserName;
};
Anggota
Kelas Win32_NetworkConnection memiliki jenis anggota ini:
Properti
Kelas Win32_NetworkConnection memiliki properti ini.
-
AccessMask
-
-
Jenis data: uint32
-
Jenis akses: Baca-saja
-
Kualifikasi: Skema ("Win32")
Daftar hak akses ke file atau direktori yang diberikan yang dipegang oleh pengguna atau grup yang atas nama instans dikembalikan. Pada volume FAT, nilai FULL_ACCESS dikembalikan sebagai gantinya, menunjukkan tidak ada keamanan yang ditetapkan pada objek .
-
-
FILE_READ_DATA (file) atau FILE_LIST_DIRECTORY (direktori) (1)
-
Memberikan hak untuk membaca data dari file. Untuk direktori, nilai ini memberikan hak untuk mencantumkan konten direktori.
-
FILE_WRITE_DATA (file) atau FILE_ADD_FILE (direktori) (2)
-
Memberikan hak untuk menulis data ke file. Untuk direktori, nilai ini memberikan hak untuk membuat file di direktori.
-
FILE_APPEND_DATA (file) atau FILE_ADD_SUBDIRECTORY (4)
-
Memberikan hak untuk menambahkan data ke file. Untuk direktori, nilai ini memberikan hak untuk membuat subdirektori.
-
FILE_READ_EA (8)
-
Memberikan hak untuk membaca atribut yang diperluas.
-
FILE_WRITE_EA (16)
-
Memberikan hak untuk menulis atribut yang diperluas.
-
FILE_EXECUTE (file) atau FILE_TRAVERSE (direktori) (32)
-
Memberikan hak untuk menjalankan file. Untuk direktori, direktori dapat dilalui.
-
FILE_DELETE_CHILD (direktori) (64)
-
Memberikan hak untuk menghapus direktori dan semua file yang dikandungnya (turunannya), meskipun file bersifat baca-saja.
-
FILE_READ_ATTRIBUTES (128)
-
Memberikan hak untuk membaca atribut file.
-
FILE_WRITE_ATTRIBUTES (256)
-
Memberikan hak untuk mengubah atribut file.
-
HAPUS (65536)
-
Memberikan akses penghapusan.
-
READ_CONTROL (131072)
-
Memberikan akses baca ke pendeskripsi dan pemilik keamanan.
-
WRITE_DAC (262144)
-
Memberikan akses tulis ke daftar kontrol akses diskresi (DACL).
-
WRITE_OWNER (524288)
-
Menetapkan pemilik tulis.
-
SINKRONKAN (1048576)
-
Menyinkronkan akses dan memungkinkan proses menunggu objek memasuki status tersinyap.
Keterangan
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (64), DisplayName ("Keterangan")
Deskripsi tekstual singkat dari objek .
Properti ini diwarisi dari CIM_ManagedSystemElement.
Komentar
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Jaringan Windows| NETRESOURCE|lpComment")
Komentar yang diberikan oleh penyedia jaringan.
ConnectionState
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (20), MappingStrings ("Win32API| Struktur Manajemen Jaringan| | USE_INFO_1 ui1_status")
Status koneksi jaringan saat ini.
Tersambung ("Tersambung")
Kesalahan ("Kesalahan")
Dijeda ("Dijeda")
Sambungan Terputus ("Terputus")
Menyambungkan ("Menyambungkan")
Menyambungkan kembali ("Menyambungkan Kembali")
ConnectionType
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Jaringan Windows| NETRESOURCE|dwScope")
Jenis persistensi koneksi yang digunakan untuk menyambungkan ke jaringan.
Koneksi Saat Ini ("Koneksi Saat Ini")
Koneksi Persisten ("Koneksi Persisten")
Deskripsi
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Deskripsi")
Deskripsi tekstual objek.
Properti ini diwarisi dari CIM_ManagedSystemElement.
DisplayType
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Jaringan Windows| NETRESOURCE|dwDisplayType")
Objek jaringan harus ditampilkan dalam antarmuka pengguna penjelajahan jaringan.
Domain ("Domain")
Generik ("Generik")
Server ("Server")
Bagikan ("Berbagi")
InstallDate
-
Jenis data: tanggalwaktu
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")
Menunjukkan kapan objek diinstal. Kurangnya nilai tidak menunjukkan bahwa objek tidak diinstal.
Properti ini diwarisi dari CIM_ManagedSystemElement.
LocalName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Jaringan Windows| SUMBER DAYA| NET lpLocalName")
Nama lokal perangkat jaringan yang tersambung.
Contoh: "c:\public"
Nama
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: key, Override ("Name"), MappingStrings ("Win32API| Struktur Jaringan Windows| NETRESOURCE")
Nama koneksi jaringan saat ini. Ini adalah kombinasi dari nilai di RemoteName dan LocalName.
Contoh: "\\NTRELEASE (c:\public)"
Terus-menerus
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Fungsi Jaringan Windows| WNetEnumResource")
Koneksi akan disambungkan kembali secara otomatis oleh sistem operasi pada log masuk berikutnya.
ProviderName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Jaringan Windows| SUMBER DAYA| NET lpProvider")
Nama penyedia yang memiliki sumber daya. Properti ini bisa NULL jika nama penyedia tidak diketahui.
RemoteName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Jaringan Windows| SUMBER DAYA| NET lpRemoteName")
Nama sumber daya jaringan jarak jauh untuk sumber daya jaringan. Untuk koneksi saat ini atau persisten, RemoteName berisi nama jaringan yang terkait dengan nama nilai di properti LocalName . Nama di RemoteName harus mengikuti konvensi penamaan penyedia jaringan.
Contoh: "\\NTRELEASE"
RemotePath
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Jaringan Windows| SUMBER DAYA| NET lpRemoteName")
Jalur lengkap ke sumber daya jaringan.
Contoh: "\\infosrv1\public"
ResourceType
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Struktur Jaringan Windows| SUMBER DAYA| NET dwType")
Jenis sumber daya yang akan dijumlahkan atau disambungkan.
Disk ("Disk")
Cetak ("Cetak")
Apa pun ("Apa pun")
Status
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (10), DisplayName ("Status")
String yang menunjukkan status objek saat ini. Status operasional dan non-operasional dapat ditentukan. Status operasional dapat mencakup "OK", "Terdegradasi", dan "Pred Fail". "Pred Fail" menunjukkan bahwa elemen berfungsi dengan baik, tetapi memprediksi kegagalan (misalnya, hard disk drive berkemampuan SMART).
Status non-operasional dapat mencakup "Kesalahan", "Mulai", "Berhenti", dan "Layanan". "Layanan" dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya. Tidak semua pekerjaan tersebut online, tetapi elemen terkelola tidak "OK" atau di salah satu status lainnya.
Properti ini diwarisi dari CIM_ManagedSystemElement.
Nilai yang valid mencakup sebagai berikut:
OK ("OK")
Kesalahan ("Kesalahan")
Terdegradasi ("Terdegradasi")
Tidak diketahui ("Tidak Diketahui")
Pred Fail ("Pred Fail")
Memulai ("Memulai")
Menghentikan ("Berhenti")
Layanan ("Layanan")
Stres ("Stres")
NonRecover ("NonRecover")
Tidak Ada Kontak ("Tidak Ada Kontak")
Lost Comm ("Lost Comm")
UserName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MappingStrings ("Win32API| Fungsi Jaringan Windows| WNetGetUser")
Nama pengguna atau nama pengguna default yang digunakan untuk membuat koneksi jaringan.
Contoh: "SYSTEM"
Keterangan
Kelas Win32_NetworkConnection berasal dari CIM_LogicalElement.
Contoh
Sampel kode VBScript berikut mengambil informasi tentang koneksi jaringan lokal.
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\Root\CIMv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_NetworkConnection",,48)
For Each objItem in colItems
Wscript.Echo "AccessMask: " & objItem.AccessMask
Wscript.Echo "Caption: " & objItem.Caption
Wscript.Echo "Comment: " & objItem.Comment
Wscript.Echo "ConnectionState: " & objItem.ConnectionState
Wscript.Echo "ConnectionType: " & objItem.ConnectionType
Wscript.Echo "Description: " & objItem.Description
Wscript.Echo "DisplayType: " & objItem.DisplayType
Wscript.Echo "InstallDate: " & objItem.InstallDate
Wscript.Echo "LocalName: " & objItem.LocalName
Wscript.Echo "Name: " & objItem.Name
Wscript.Echo "Persistent: " & objItem.Persistent
Wscript.Echo "ProviderName: " & objItem.ProviderName
Wscript.Echo "RemoteName: " & objItem.RemoteName
Wscript.Echo "RemotePath: " & objItem.RemotePath
Wscript.Echo "ResourceType: " & objItem.ResourceType
Wscript.Echo "Status: " & objItem.Status
Wscript.Echo "UserName: " & objItem.UserName
Next
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista |
Server minimum yang didukung |
Windows Server 2008 |
Ruang nama |
Root\CIMV2 |
MOF |
|
DLL |
|
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk