Win32_Share-Klasse

  • Artikel

Die Win32_Share-Klasse stellt eine freigegebene Ressource auf einem Computersystem mit Windows dar. Dies kann ein Datenträgerlaufwerk, ein Drucker, eine Interprocess-Kommunikation oder ein anderes speicherbares Gerät sein. Weitere Informationen zum Abrufen von WMI-Klassen finden Sie unter Abrufen einer Klasse.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften und Methoden befinden sich in alphabetischer Reihenfolge, nicht in MOF-Reihenfolge.

Syntax

[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;
};

Member

Die Win32_Share-Klasse verfügt über die folgenden Membertypen:

Methoden

Die Win32_Share-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
Erstellen Klassenmethode, die die Freigabe für eine Serverressource initiiert.
Löschen Klassenmethode, die einen Freigabenamen aus der Liste der freigegebenen Ressourcen eines Servers löscht und Verbindungen mit der freigegebenen Ressource trennt.
GetAccessMask Gibt die Zugriffsrechte für die Freigabe des Benutzers oder der Gruppe zurück, in deren Namen der instance zurückgegeben wird. Sie sollten diese Methode anstelle der AccessMask-Eigenschaft verwenden, die immer NULL ist.
SetShareInfo Klassenmethode, die die Parameter einer freigegebenen Ressource festlegt.

 

Eigenschaften

Die Win32_Share-Klasse verfügt über diese Eigenschaften.

Accessmask

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: VERALTET

Diese Eigenschaft ist veraltet und wird nicht mehr verwendet. Verwenden Sie stattdessen die Win32_Share.GetAccessMask-Methode . Der Wert der AccessMask-Eigenschaft wird von WMI auf NULL festgelegt. Weitere Informationen zum Festlegen des Zugriffs beim Erstellen einer Freigabe finden Sie in der Create-Methode .

AllowMaximum

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| SHARE_INFO_502|shi502_max_uses")

Die Anzahl gleichzeitiger Benutzer für diese Ressource wurde begrenzt. Bei True wird der Wert in der MaximumAllowed-Eigenschaft ignoriert.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Textbeschreibung des -Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts bedeutet nicht, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

MaximumAllowed

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| SHARE_INFO_502|shi502_max_uses")

Begrenzen Sie die maximale Anzahl von Benutzern, die diese Ressource gleichzeitig verwenden dürfen. Der Wert ist nur gültig, wenn die AllowMaximum-Eigenschaft auf FALSE festgelegt ist.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: schlüssel, überschreiben ("Name"), MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| SHARE_INFO_1|shi1_netname")

Alias für einen Pfad angegeben, der als Freigabe auf einem Computersystem mit Windows eingerichtet ist.

Windows 2008-Beispiel: "\SERVER01\public" – Windows Server 2008 erfordert, dass Sie den UNC im Namen platzieren.

Pfad

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| SHARE_INFO_502|shi502_path")

Lokaler Pfad der Windows-Freigabe.

Beispiel: "C:\Programme"

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Zeichenfolge, die den aktuellen status des Objekts angibt. Es können operative und nicht operative status definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. ein SMART-fähiges Festplattenlaufwerk).

Nicht betriebsbereite status können "Error", "Starting", "Stop" und "Service" enthalten. "Dienst" kann beim Spiegel des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Wird beendet")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

Typ

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Netzwerkverwaltungsstrukturen| SHARE_INFO_502|shi502_type")

Typ der freigegebenen Ressource. Zu den Typen gehören: Datenträgerlaufwerke, Druckwarteschlangen, Interprocess Communications (IPC) und allgemeine Geräte.

Datenträgerlaufwerk (0)

Druckwarteschlange (1)

Gerät (2)

IPC (3)

Datenträgerlaufwerk Admin (2147483648)

Admin der Druckwarteschlange (2147483649)

Device Admin (2147483650)

IPC-Admin (2147483651)

Bemerkungen

Die Win32_Share-Klasse wird von CIM_LogicalElement abgeleitet.

Die Create-Methode in dieser Klasse ist eine statische Methode. Die Methoden Delete, GetAccessMask und SetShareInfo sind alle instance Methoden.

Abhängig von Ihren Sicherheitsberechtigungen können Sie möglicherweise nicht alle Eigenschaften dieser Klasse abrufen. Beispielsweise können die Eigenschaften AllowMaximum, MaximumAllowed, Path und Type NULL zurückgeben. Im Allgemeinen können Power Users und Administratoren alle Eigenschaftswerte abrufen.

Beispiele

Im folgendenSkriptcenter-Codebeispiel werden alle Freigaben auf einem Computer und alle Freigabeberechtigungen für jede Freigabe aufgelistet.

Das Abrufen von Freigabeinformationen ähnlich Win32_Share PowerShell-Beispielabfragen Win32_Share und stellt die Ergebnisse bereit.

Im folgenden PowerShell-Beispiel werden die Freigaben auf dem lokalen System angezeigt.

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

Wenn Sie genauer filtern möchten, können Sie alternativ den folgenden PowerShell-Codeausschnitt verwenden:

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

Im folgenden VBScript-Beispiel werden die Freigaben auf dem lokalen System angezeigt.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

CIM_LogicalElement

Betriebssystemklassen

WMI-Aufgaben: Dateien und Ordner