Create-Methode der Win32 _ Share-Klasse
Die Create WMI-Klassenmethode initiiert die Freigabe für eine Serverressource.
In diesem Thema wird Managed Object Format (MOF)-Syntax 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 eingerichtet ist, auf dem Windows.
Beispiel: "public".
-
Typ [ In]
-
Übergibt den Typ der ressource, die freigegeben wird. Zu den Typen zählen Laufwerke, Druckwarteschlangen, prozessübergreifende Kommunikation (Interprocess Communications, IPC) und allgemeine Geräte. Kann einer der folgenden Werte sein.
-
Laufwerk (0)
-
Druckwarteschlange (1)
-
Gerät (2)
-
IPC (3)
-
Datenträgerlaufwerkadministrator (2147483648)
-
Druckwarteschlangenadministrator (2147483649)
-
Geräteadministrator (2147483650)
-
IPC Admin (2147483651)
MaximumAllowed [ in, optional]
Begrenzen Sie die maximale Anzahl von Benutzern, die diese Ressource gleichzeitig verwenden dürfen.
Beispiel: 10. Dieser Parameter ist optional.
Beschreibung [ in, optional]
Optionaler Kommentar, um die freigegebene Ressource zu beschreiben. 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. Ein Sicherheitsdeskriptor 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 Changing Access Security on Securable Objects.
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-Fehlerkonstistenzen 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)
-
Net name not found (25)
-
Andere (26 4294967295)
Hinweise
Create ist eine statische Methode.
Nur Mitglieder der lokalen Gruppe Administratoren oder Kontooperatoren oder Mitglieder der Operatorgruppe Communication, Print oder Server können create erfolgreich ausführen. Der Druckeroperator kann nur Druckerwarteschlangen hinzufügen. Der Kommunikationsoperator kann nur Kommunikationsgerätewarteschlangen hinzufügen.
Beispiele
Im PowerShell-Beispiel "Dateifreigaben exportieren und importieren" werden Dateifreigaben exportiert und importiert und Freigabeberechtigungen definiert. Ebenso erstellt das Beispiel Create a Share and Set Permissions (Freigabe erstellen und Berechtigungen festlegen) auch eine neue Freigabe und legt die Freigabeberechtigungen fest.
Mit dem folgenden PowerShell-Code wird eine Freigabe erstellt.
# 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 sie die create-Methode aufruft.
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) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|