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 |
|
| DLL |
|