Win32 _ Share-Klasse

Die Win32 _ Share-Klasse stellt eine freigegebene Ressource auf einem Computersystem dar, auf dem Windows ausgeführt wird. Dabei kann es sich um ein Laufwerk, einen Drucker, eine prozessübergreifende Kommunikation oder ein anderes trennbares Gerät handelt. 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 werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge sortiert.

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 diese Typen von Membern:

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 zurück, die vom Benutzer oder der Gruppe gehalten wird, in dessen Namen die Instanz 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 unter Create-Methode.

AllowMaximum

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API-Netzwerkverwaltungsstrukturen | SHARE INFO | _ _ 502 | shi502 _ max _ uses")

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

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Beschreibung")

Eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

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 gibt nicht an, dass das Objekt nicht installiert ist.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

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: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: key, Override ("Name"), MappingStrings ("Win32API | Network Management Structures SHARE INFO | _ _ 1 | shi1 _ netname")

Alias für einen Pfad, 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.

Path

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API-Netzwerkverwaltungsstrukturen | SHARE INFO | _ _ 502 | shi502 _ path")

Lokaler Pfad der Windows Freigabe.

Beispiel: "C: \ Programme"

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Zeichenfolge, die den aktuellen Status des Objekts angibt. Der Betriebsstatus und der nicht betriebsbereite Status können definiert werden. Der Betriebsstatus kann "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" 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", "Stopping" und "Service" sein. "Dienst" kann während der Datenträgerspiegelung, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle dieser Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Heruntergestuft ("Heruntergestuft")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Wird beendet ("Wird beendet")

Dienst ("Dienst")

Striche ("Strich")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

Typ

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API | Network Management Structures SHARE INFO | _ _ 502 | shi502 _ type")

Der Typ der Ressource, die freigegeben wird. Folgende Typen sind möglich: Laufwerke, Druckwarteschlangen, prozessübergreifende Kommunikation (Interprocess Communications, IPC) und allgemeine Geräte.

Laufwerk (0)

Druckwarteschlange (1)

Gerät (2)

IPC (3)

Datenträgerlaufwerkadministrator (2147483648)

Druckwarteschlangenadministrator (2147483649)

Geräteadministrator (2147483650)

IPC Admin (2147483651)

Hinweise

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 Instanzmethoden.

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 folgenden ScriptCenter-Codebeispiel werden alle Freigaben auf einem Computer und alle Freigabeberechtigungen für jede Freigabe aufgeführt.

Das PowerShell-Beispiel get share information similar to Win32 _ Share fragt Win32 Share ab _ und stellt die Ergebnisse zur Verfügung.

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 präziser 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)
Windows Server 2008
Namespace
\Stamm-CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

CIM _ LogicalElement

Betriebssystemklassen

WMI-Aufgaben: Dateien und Ordner