classe Win32_Share

La classe Win32_Share représente une ressource partagée sur un système informatique exécutant Windows. Il peut s’agir d’un lecteur de disque, d’une imprimante, d’une communication interprocess ou d’un autre appareil partageable. Pour plus d’informations sur la récupération de classes WMI, consultez Récupération d’une classe.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés et les méthodes sont dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

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

Membres

La classe Win32_Share a les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

La classe Win32_Share possède ces méthodes.

Méthode	Description
Créer	Méthode de classe qui lance le partage pour une ressource serveur.
Supprimer	Méthode de classe qui supprime un nom de partage de la liste des ressources partagées d’un serveur, en déconnectant les connexions à la ressource partagée.
GetAccessMask	Retourne les droits d’accès au partage détenu par l’utilisateur ou le groupe au nom duquel le instance est retourné. Vous devez utiliser cette méthode à la place de la propriété AccessMask , qui est toujours NULL.
SetShareInfo	Méthode de classe qui définit les paramètres d’une ressource partagée.

 

Propriétés

La classe Win32_Share possède ces propriétés.

AccessMask

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : DEPRECATED

Cette propriété est obsolète et n’est plus utilisée. Utilisez plutôt la méthode Win32_Share.GetAccessMask . La valeur de la propriété AccessMask est définie sur null par WMI. Pour plus d’informations sur la définition de l’accès lors de la création d’un partage, consultez la méthode Create .

AllowMaximum

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau | SHARE_INFO_502|shi502_max_uses »)

Le nombre d’utilisateurs simultanés pour cette ressource a été limité. Si la valeur est True, la valeur de la propriété MaximumAllowed est ignorée.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Description »)

Description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

MaximumAllowed

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau | SHARE_INFO_502|shi502_max_uses »)

Limite du nombre maximal d’utilisateurs autorisés à utiliser cette ressource simultanément. La valeur est valide uniquement si la propriété AllowMaximum a la valeur FALSE.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : key, Override (« Name »), MappingStrings (« Win32API| Structures de gestion réseau | SHARE_INFO_1|shi1_netname »)

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

Exemple Windows 2008 : « \SERVER01\public » - Windows Server 2008 nécessite que vous placez l’UNC dans le nom.

Chemin d’accès

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau | SHARE_INFO_502|shi502_path »)

Chemin d’accès local du partage Windows.

Exemple : « C:\Program Files »

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Chaîne qui indique la status actuelle de l’objet. Il est possible de définir des status opérationnels et non opérationnels. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un disque dur smart).

Les status non opérationnelles peuvent inclure « Error », « Starting », « Stopping » et « Service ». « Service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Dégradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

Type

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Structures de gestion réseau| SHARE_INFO_502|shi502_type »)

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.

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)

Notes

La classe Win32_Share est dérivée de CIM_LogicalElement.

La méthode Create de cette classe est une méthode statique. Les méthodes Delete, GetAccessMask et SetShareInfo sont toutes instance méthodes.

Selon vos autorisations de sécurité, vous ne pourrez peut-être pas récupérer toutes les propriétés de cette classe. Par exemple, les propriétés AllowMaximum, MaximumAllowed, Path et Type peuvent retourner null. En règle générale, les utilisateurs avec pouvoir et les administrateurs pourront récupérer toutes les valeurs de propriété.

Exemples

L’exemple decode centre de scripts suivant répertorie tous les partages sur un ordinateur et répertorie toutes les autorisations de partage pour chaque partage.

L’exemple Obtenir des informations sur le partage semblable à Win32_Share exemples de requêtes PowerShell Win32_Share et fournit les résultats.

L’exemple PowerShell suivant affiche les partages sur le système local.

$shares = Get-WMIObject -class Win32_share
"Shares on : {0}" -f $((gwmi win32_computersystem).name)
$shares | sort name | ft -auto

Si vous souhaitez filtrer plus précisément, vous pouvez également utiliser l’extrait de code PowerShell suivant :

gwmi -q "SELECT * FROM Win32_Share WHERE Name != 'ADMIN$' AND Name != 'IPC$'"

L’exemple VBScript suivant affiche les partages sur le système local.

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

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

CIM_LogicalElement

Classes du système d’exploitation

Tâches WMI : fichiers et dossiers