Win32_Share-Klasse
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.
[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;
};
Die Win32_Share-Klasse verfügt über die folgenden Membertypen:
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. |
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)
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.
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
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista |
Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
Namespace |
Root\CIMV2 |
MOF |
|
DLL |
|