Condividi tramite

Classe Win32_Share

  • Articolo

La classe Win32_Share rappresenta una risorsa condivisa in un sistema computer che esegue Windows. Può trattarsi di un'unità disco, una stampante, una comunicazione interprocesso o un altro dispositivo condivisibile. Per altre informazioni sul recupero di classi WMI, vedere Recupero di una classe.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà e i metodi sono in ordine alfabetico, non in ordine MOF.

Sintassi

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

Membri

La classe Win32_Share include questi tipi di membri:

Metodi

La classe Win32_Share dispone di questi metodi.

Metodo Descrizione
Crea Metodo di classe che avvia la condivisione per una risorsa server.
CANC Metodo di classe che elimina un nome di condivisione dall'elenco di risorse condivise di un server, disconnettendo le connessioni alla risorsa condivisa.
GetAccessMask Restituisce i diritti di accesso alla condivisione detenuta dall'utente o dal gruppo per conto del quale viene restituita l'istanza. È consigliabile utilizzare questo metodo al posto della proprietà AccessMask , che è sempre NULL.
SetShareInfo Metodo di classe che imposta i parametri di una risorsa condivisa.

 

Proprietà

La classe Win32_Share ha queste proprietà.

Accessmask

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: DEPRECATO

Questa proprietà è obsoleta e non viene più utilizzata. Usare invece il metodo Win32_Share.GetAccessMask. Il valore della proprietà AccessMask è impostato su Null da WMI. Per altre informazioni sull'impostazione dell'accesso quando viene creata una condivisione, vedere il metodo Create.

AllowMaximum

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |SHARE_INFO_502|shi502_max_uses")

Il numero di utenti simultanei per questa risorsa è stato limitato. Se True, il valore nella proprietà MaximumAllowed viene ignorato.

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

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

Breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |ComponentID|001.5"), DisplayName ("Data di installazione")

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

MaximumAllowed

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |SHARE_INFO_502|shi502_max_uses")

Limite al numero massimo di utenti autorizzati a usare questa risorsa contemporaneamente. Il valore è valido solo se la proprietà AllowMaximum è impostata su FAL edizione Standard.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: chiave, override ("Nome"), MappingStrings ("Win32API|Strutture di gestione della rete |SHARE_INFO_1|shi1_netname")

Alias assegnato a un percorso configurato come condivisione in un sistema computer che esegue Windows.

Esempio di Windows 2008: "\edizione Standard RVER01\public" - Windows Server 2008 richiede di inserire l'UNC nel nome.

Percorso

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |SHARE_INFO_502|shi502_path")

Percorso locale della condivisione di Windows.

Esempio: "C:\Programmi"

Stato

Tipo di dati: string

Tipo di accesso: sola lettura

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

Stringa che indica lo stato corrente dell'oggetto. È possibile definire lo stato operativo e non operativo. Lo stato operativo può includere "OK", "Danneggiato" e "Pred Fail". "Pred Fail" indica che un elemento funziona correttamente, ma prevede un errore (ad esempio, un'unità disco rigido abilitata per SMART).

Lo stato non operativo può includere "Error", "Starting", "Stopping" e "Service". Il "servizio" può essere applicato durante il ridimensionamento del mirroring del disco, il ricaricamento di un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutte queste operazioni sono online, ma l'elemento gestito non è né "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore ")

Degradato ("degradato")

Sconosciuto ("Sconosciuto")

Pred Fail ("Pred Fail ")

Avvio ("Starting ")

Arresto ("arresto ")

Servizio ("Servizio")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

Type

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Strutture di gestione della rete |SHARE_INFO_502|shi502_type")

Tipo di risorsa condivisa. I tipi includono unità disco, code di stampa, comunicazioni interprocessi (IPC) e dispositivi generali.

Unità disco (0)

Coda di stampa (1)

Dispositivo (2)

IPC (3)

Amministrazione unità disco (2147483648)

Amministrazione coda di stampa (2147483649)

Amministrazione del dispositivo (2147483650)

IPC Amministrazione (2147483651)

Osservazioni:

La classe Win32_Share deriva da CIM_LogicalElement.

Il metodo Create in questa classe è un metodo statico. I metodi Delete, GetAccessMask e SetShareInfo sono tutti metodi di istanza.

A seconda delle autorizzazioni di sicurezza, potrebbe non essere possibile recuperare tutte le proprietà di questa classe. Ad esempio, le proprietà AllowMaximum, MaximumAllowed, Path e Type possono restituire null. In generale, Power Users e Amministrazione istrator saranno in grado di recuperare tutti i valori delle proprietà.

Esempi

Nell'esempio di PowerShell seguente vengono visualizzate le condivisioni nel sistema locale.

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

In alternativa, se si vuole filtrare in modo più preciso, è possibile usare il frammento di codice di PowerShell seguente:

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

Nell'esempio VBScript seguente vengono visualizzate le condivisioni nel sistema locale.

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

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

CIM_LogicalElement

Classi del sistema operativo

Attività WMI: file e cartelle