Bagikan melalui

kelas Win32_Share

  • Artikel

Kelas Win32_Share mewakili sumber daya bersama pada sistem komputer yang menjalankan Windows. Ini mungkin drive disk, printer, komunikasi antarproseksi, atau perangkat lain yang dapat dibagikan. Untuk informasi selengkapnya tentang mengambil kelas WMI, lihat Mengambil Kelas.

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("{8502C4D6-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), AMENDMENT]
class Win32_Share : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  boolean  AllowMaximum;
  uint32   MaximumAllowed;
  string   Name;
  string   Path;
  uint32   Type;
};

Anggota

Kelas Win32_Share memiliki jenis anggota ini:

Metode

Kelas Win32_Share memiliki metode ini.

Metode Deskripsi
Buat Metode kelas yang memulai berbagi untuk sumber daya server.
Hapus Metode kelas yang menghapus nama berbagi dari daftar sumber daya bersama server, memutuskan koneksi ke sumber daya bersama.
GetAccessMask Mengembalikan hak akses ke berbagi yang dipegang oleh pengguna atau grup atas nama instans yang dikembalikan. Anda harus menggunakan metode ini sebagai pengganti properti AccessMask , yang selalu NULL.
SetShareInfo Metode kelas yang mengatur parameter sumber daya bersama.

 

Properti

Kelas Win32_Share memiliki properti ini.

AccessMask

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: TIDAK DIGUNAKAN LAGI

Properti ini usang dan tidak lagi digunakan. Gunakan metode Win32_Share.GetAccessMask sebagai gantinya. Nilai properti AccessMask diatur ke null oleh WMI. Untuk informasi selengkapnya tentang mengatur akses saat berbagi dibuat, lihat metode Buat.

AllowMaximum

Jenis data: boolean

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan|SHARE_INFO_502|shi502_max_uses")

Jumlah pengguna bersamaan untuk sumber daya ini telah dibatasi. Jika True, nilai dalam properti MaximumAllowed diabaikan.

Caption

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (64), DisplayName ("Keterangan")

Deskripsi tekstual singkat objek.

Properti ini diwariskan dari CIM_ManagedSystemElement.

Keterangan

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: DisplayName ("Description")

Deskripsi tekstual objek.

Properti ini diwariskan dari CIM_ManagedSystemElement.

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 diwariskan dari CIM_ManagedSystemElement.

MaximumAllowed

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan|SHARE_INFO_502|shi502_max_uses")

Batasi jumlah maksimum pengguna yang diizinkan untuk menggunakan sumber daya ini secara bersamaan. Nilai hanya valid jika properti AllowMaximum diatur ke FALSE.

Nama

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: key, Override ("Name"), MappingStrings ("Win32API|Struktur Manajemen Jaringan|SHARE_INFO_1|shi1_netname")

Alias yang diberikan ke jalur yang disiapkan sebagai berbagi pada sistem komputer yang menjalankan Windows.

Contoh Windows 2008: "\SERVER01\public" - Windows Server 2008 mengharuskan Anda menempatkan UNC dalam nama.

Jalur

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan|SHARE_INFO_502|shi502_path")

Jalur lokal berbagi Windows.

Contoh: "C:\Program Files"

Keadaan

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", "Degraded", 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 diwariskan dari CIM_ManagedSystemElement.

Nilai mencakup yang 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")

Comm Hilang ("Hilang Comm")

Jenis

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API|Struktur Manajemen Jaringan|SHARE_INFO_502|shi502_type")

Jenis sumber daya yang dibagikan. Jenisnya meliputi: drive disk, antrean cetak, komunikasi antarproseksi (IPC), dan perangkat umum.

Disk Drive (0)

Antrean Cetak (1)

Perangkat (2)

IPC (3)

Admin Disk Drive (2147483648)

Admin Antrean Cetak (2147483649)

Admin Perangkat (2147483650)

Admin IPC (2147483651)

Keterangan

Kelas Win32_Share berasal dari CIM_LogicalElement.

Metode Buat di kelas ini adalah metode statis. Metode Delete, GetAccessMask , dan SetShareInfo adalah semua metode instans.

Bergantung pada izin keamanan, Anda mungkin tidak dapat mengambil semua properti kelas ini. Misalnya, properti AllowMaximum, MaximumAllowed, Path, dan Type dapat mengembalikan null. Secara umum, Pengguna Dan Administrator Power akan dapat mengambil semua nilai properti.

Contoh

Sampel PowerShell berikut menampilkan berbagi pada sistem lokal.

$shares = Get-WMIObject -class Win32_share
"Shares on : {0}" -f $((gwmi win32_computersystem).name)
$shares | sort name | ft -auto

Sebagai alternatif, jika Anda ingin memfilter dengan lebih tepat, Anda bisa menggunakan cuplikan PowerShell berikut:

gwmi -q "SELECT * FROM Win32_Share WHERE Name != 'ADMIN$' AND Name != 'IPC$'"

Sampel VBScript Berikut menampilkan berbagi pada sistem lokal.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_Share")


For Each objItem in colItems 
 Wscript.Echo "Name: " & objItem.Name
 Wscript.Echo "Caption: " & objItem.Caption & "=" & objItem.Path
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

Baca juga

CIM_LogicalElement

Kelas Sistem Operasi

Tugas WMI: File dan Folder