Compartir a través de

Win32_Share clase

  • Artículo

La clase Win32_Share representa un recurso compartido en un sistema de equipos que ejecuta Windows. Puede tratarse de una unidad de disco, una impresora, una comunicación entre procesos u otro dispositivo que se pueda compartir. Para obtener más información sobre cómo recuperar clases WMI, vea Recuperar una clase.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades y los métodos están en orden alfabético, no en orden MOF.

Sintaxis

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

Miembros

La clase Win32_Share tiene estos tipos de miembros:

Métodos

La clase Win32_Share tiene estos métodos.

Método Descripción
Crear Método de clase que inicia el uso compartido de un recurso de servidor.
Eliminar Método de clase que elimina un nombre de recurso compartido de la lista de recursos compartidos de un servidor, desconectando las conexiones al recurso compartido.
GetAccessMask Devuelve los derechos de acceso al recurso compartido mantenido por el usuario o grupo en cuyo nombre se devuelve la instancia. Debe usar este método en lugar de la propiedad AccessMask , que siempre es NULL.
SetShareInfo Método de clase que establece los parámetros de un recurso compartido.

 

Propiedades

La clase Win32_Share tiene estas propiedades.

AccessMask

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: EN DESUSO

Esta propiedad está obsoleta y ya no se usa. En su lugar, use el método Win32_Share.GetAccessMask . WMI establece el valor de la propiedad AccessMask en null . Para obtener más información sobre cómo establecer el acceso cuando se crea un recurso compartido, vea el método Create .

AllowMaximum

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de redes | SHARE_INFO_502|shi502_max_uses")

El número de usuarios simultáneos para este recurso ha sido limitado. Si es True, se omite el valor de la propiedad MaximumAllowed .

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64), DisplayName ("Caption")

Descripción textual breve del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

MaximumAllowed

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de redes | SHARE_INFO_502|shi502_max_uses")

Límite en el número máximo de usuarios que pueden usar este recurso simultáneamente. El valor solo es válido si la propiedad AllowMaximum está establecida en FALSE.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: key, Override ("Name"), MappingStrings ("Win32API| Estructuras de administración de redes | SHARE_INFO_1|shi1_netname")

Alias dado a una ruta de acceso configurada como recurso compartido en un sistema de equipos que ejecuta Windows.

Ejemplo de Windows 2008: "\SERVER01\public" - Windows Server 2008 requiere que coloque el UNC en el nombre.

Ruta de acceso

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de redes | SHARE_INFO_502|shi502_path")

Ruta de acceso local del recurso compartido de Windows.

Ejemplo: "C:\Archivos de programa"

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (10), DisplayName ("Status")

Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Aceptar", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).

El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante el resilvering de reflejo del disco, volver a cargar una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "OK" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Pred Fail ("Pred Fail ")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

Tipo

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de administración de red | SHARE_INFO_502|shi502_type")

Tipo de recurso que se comparte. Los tipos incluyen: unidades de disco, colas de impresión, comunicaciones entre procesos (IPC) y dispositivos generales.

Unidad de disco (0)

Cola de impresión (1)

Dispositivo (2)

IPC (3)

Administración de unidad de disco (2147483648)

Administración de cola de impresión (2147483649)

Administración de dispositivo (2147483650)

Administración IPC (2147483651)

Comentarios

La clase Win32_Share se deriva de CIM_LogicalElement.

El método Create de esta clase es un método estático. Los métodos Delete, GetAccessMask y SetShareInfo son todos los métodos de instancia.

En función de los permisos de seguridad, es posible que no pueda recuperar todas las propiedades de esta clase. Por ejemplo, las propiedades AllowMaximum, MaximumAllowed, Path y Type pueden devolver null. Por lo general, los usuarios avanzados y los administradores podrán recuperar todos los valores de propiedad.

Ejemplos

En el siguienteejemplo de código del Centro de scripts se enumeran todos los recursos compartidos de un equipo y se enumeran todos los permisos de recurso compartido para cada recurso compartido.

Obtener información de recurso compartido similar a Win32_Share consultas de ejemplo de PowerShell Win32_Share y proporciona los resultados.

En el ejemplo de PowerShell siguiente se muestran los recursos compartidos en el sistema local.

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

Como alternativa, si desea filtrar con más precisión, puede usar el siguiente fragmento de código de PowerShell:

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

En el ejemplo siguiente de VBScript se muestran los recursos compartidos en el sistema 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

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista
Servidor mínimo compatible
 Windows Server 2008
Espacio de nombres
 Root\CIMV2
MOF
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

CIM_LogicalElement

Clases de sistema operativo

Tareas de WMI: archivos y carpetas