Créer une méthode de la classe Win32_Share

Article
06/12/2023

La méthode CreateWMI class lance le partage pour une ressource serveur.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

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
);

Paramètres

Chemin d’accès [in]

Chemin d’accès local du partage Windows.

Exemple, « C:\Program Files ».

Nom [in]

Transmet l’alias à un chemin d’accès configuré en tant que partage sur un système informatique exécutant Windows.

Exemple, « public ».

Type [in]

Transmet le type de ressource partagée. Les types incluent les lecteurs de disque, les files d’attente d’impression, les communications interprocessus (IPC) et les appareils généraux. Il peut s’agir de l’une des valeurs suivantes.

Lecteur de disque (0)

File d’attente d’impression (1)

Appareil (2)

IPC (3)

Disk Drive Administration (2147483648)

Administration file d’attente d’impression (2147483649)

Administration d’appareil (2147483650)

Administration IPC (2147483651)

MaximumAllowed [in, optional]

Limitez le nombre maximal d’utilisateurs autorisés à utiliser simultanément cette ressource.

Exemple : 10. Ce paramètre est facultatif.

Description [in, facultatif]

Commentaire facultatif pour décrire la ressource partagée. Ce paramètre est facultatif.

Mot de passe [in, facultatif]

Mot de passe (lorsque le serveur s’exécute avec la sécurité au niveau du partage) pour la ressource partagée. Si le serveur s’exécute avec la sécurité au niveau de l’utilisateur, ce paramètre est ignoré. Ce paramètre est facultatif.

Access [in, facultatif]

Descripteur de sécurité pour les autorisations au niveau de l’utilisateur. Un descripteur de sécurité contient des informations sur les autorisations, le propriétaire et les fonctionnalités d’accès de la ressource. Si ce paramètre n’est pas fourni ou a la valeur NULL, tout le monde a accès en lecture au partage. Pour plus d’informations, consultez Win32_SecurityDescriptor et Modification de la sécurité d’accès sur les objets sécurisables.

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante, ou toute autre valeur pour indiquer une erreur. Pour obtenir des codes d’erreur supplémentaires, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Réussite (0)
Accès refusé (2)
Échec inconnu (8)
Nom non valide (9)
Niveau non valide (10)
Paramètre non valide (21)
Partage en double (22)
Chemin redirigé (23)
Appareil ou répertoire inconnu (24)
Nom net introuvable (25)
Autres (26 4294967295)

Notes

Create est une méthode statique.

Seuls les membres du groupe local Administrateurs ou Opérateurs de compte ou ceux ayant une appartenance au groupe d’opérateurs Communication, Impression ou Serveur peuvent exécuter correctement La création. L’opérateur Print peut uniquement ajouter des files d’attente d’imprimantes. L’opérateur communication ne peut ajouter que des files d’attente d’appareils de communication.

Exemples

L’exemple d’exportation et d’importation de partages de fichiers PowerShell exporte et importe des partages de fichiers et définit des autorisations de partage. De même, l’exemple Créer un partage et définir des autorisations crée également un partage et définit les autorisations de partage.

Le code PowerShell suivant crée un partage.

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

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

# see results
gwmi win32_share

L’exemple de code précédent retourne ce qui suit :

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

L’exemple de code C# suivant décrit comment appeler la méthode create.

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);
 }

}

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Classes du système d’exploitation
Win32_Share

Partager via