Share via

kelas Win32_NetworkConnection

  • Artikel

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
CIMWin32.mof
DLL
CIMWin32.dll

Lihat juga

CIM_LogicalElement

Kelas Sistem Operasi