Create-Methode der Win32_Share-Klasse

Artikel
06/12/2023

Die CreateWMI-Klassenmethode initiiert die Freigabe für eine Serverressource.

In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

uint32 Create(
  [in]           string                   Path,
  [in]           string                   Name,
  [in]           uint32                   Type,
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] string                   Password,
  [in, optional] Win32_SecurityDescriptor Access
);

Parameter

Pfad [in]

Lokaler Pfad der Windows-Freigabe.

Beispiel: "C:\Programme".

Name [in]

Übergibt den Alias an einen Pfad, der als Freigabe auf einem Computersystem unter Windows eingerichtet ist.

Beispiel: "public".

Geben Sie [in] ein.

Übergibt den Typ der freigegebenen Ressource. Zu den Typen gehören Datenträgerlaufwerke, Druckwarteschlangen, Interprocess Communications (IPC) und allgemeine Geräte. Kann einer der folgenden Werte sein.

Datenträgerlaufwerk (0)

Druckwarteschlange (1)

Gerät (2)

IPC (3)

Datenträgerlaufwerk Admin (2147483648)

Admin der Druckwarteschlange (2147483649)

Device Admin (2147483650)

IPC-Admin (2147483651)

MaximumAllowed [in, optional]

Limit für die maximale Anzahl von Benutzern, die diese Ressource gleichzeitig verwenden dürfen.

Beispiel: 10. Dieser Parameter ist optional.

Beschreibung [in, optional]

Optionaler Kommentar zur Beschreibung der freigegebenen Ressource. Dieser Parameter ist optional.

Kennwort [in, optional]

Kennwort (wenn der Server mit Sicherheit auf Freigabeebene ausgeführt wird) für die freigegebene Ressource. Wenn der Server mit Sicherheit auf Benutzerebene ausgeführt wird, wird dieser Parameter ignoriert. Dieser Parameter ist optional.

Zugriff [in, optional]

Sicherheitsbeschreibung für Berechtigungen auf Benutzerebene. Eine Sicherheitsbeschreibung enthält Informationen zu den Berechtigungen, Besitzern und Zugriffsfunktionen der Ressource. Wenn dieser Parameter nicht angegeben wird oder NULL ist, hat jeder Lesezugriff auf die Freigabe. Weitere Informationen finden Sie unter Win32_SecurityDescriptor und Ändern der Zugriffssicherheit für sicherungsfähige Objekte.

Rückgabewert

Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, um einen Fehler anzugeben. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Erfolg (0)
Zugriff verweigert (2)
Unbekannter Fehler (8)
Ungültiger Name (9)
Ungültige Ebene (10)
Ungültiger Parameter (21)
Doppelte Freigabe (22)
Umgeleiteter Pfad (23)
Unbekanntes Gerät oder Verzeichnis (24)
Netzname nicht gefunden (25)
Sonstige (26 4294967295)

Bemerkungen

Create ist eine statische Methode.

Erstellen können nur Mitglieder der lokalen Gruppe "Administratoren" oder "Kontooperatoren" oder mitglieder mit Der Gruppe "Kommunikation", "Druck" oder "Serveroperator " erfolgreich ausführen. Der Druckeroperator kann nur Druckerwarteschlangen hinzufügen. Der Kommunikationsoperator kann nur Kommunikationsgerätewarteschlangen hinzufügen.

Beispiele

Das PowerShell-Beispiel Zum Exportieren und Importieren von Dateifreigaben exportiert und importiert Dateifreigaben und legt Freigabeberechtigungen fest. In ähnlicher Weise erstellt das Beispiel Erstellen einer Freigabe und Festlegen von Berechtigungen auch eine neue Freigabe und legt die Freigabeberechtigungen fest.

Der folgende PowerShell-Code erstellt eine Freigabe.

# create pointer to class
$comp=[WMICLASS]"Win32_share"

# create a new share
$comp.create("c:\","mynewshare",0)

# see results
gwmi win32_share

Im vorherigen Codebeispiel wird Folgendes zurückgegeben:

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     : 
__DYNASTY        : __PARAMETERS
__RELPATH        : 
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         : 
__NAMESPACE      : 
__PATH           : 
ReturnValue      : 2
PSComputerName   : 

Name        : ADMIN$
Path        : C:\Windows
Description : Remote Admin

Name        : C$
Path        : C:\
Description : Default share

Name        : CCMLOGS$
Path        : C:\Windows\CCM\Logs
Description : Public Share

Name        : ccmsetup$
Path        : C:\Windows\ccmsetup
Description : Public Share

Name        : Drop
Path        : C:\Drop
Description : 

Name        : IPC$
Path        : 
Description : Remote IPC

Name        : Share
Path        : C:\Share
Description :

Im folgenden C#-Codebeispiel wird beschrieben, wie die create-Methode aufgerufen wird.

private static void makeShare(string servername, string filepath, string sharename)
{
try
 {
 // assemble the string so the scope represents the remote server
 string scope = string.Format("\\\\{0}\\root\\cimv2", servername);

 // connect to WMI on the remote server
 ManagementScope ms = new ManagementScope(scope);

 // create a new instance of the Win32_Share WMI object
 ManagementClass cls = new ManagementClass("Win32_Share");

 // set the scope of the new instance to that created above
 cls.Scope = ms;

 // assemble the arguments to be passed to the Create method
 object[] methodargs = { filepath, sharename, "0" };

 // invoke the Create method to create the share
 object result = cls.InvokeMethod("Create", methodargs);
 }
catch (SystemException e)
 {
  Console.WriteLine("Error attempting to create share {0}:", sharename);
  Console.WriteLine(e.Message);
 }

}

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

Betriebssystemklassen
Win32_Share

Freigeben über