classe Win32_NetworkConnection

Articolo
06/12/2023

La classe WMIWin32_NetworkConnection rappresenta una connessione di rete attiva in un ambiente basato su Windows.

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("{8502C4CD-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkConnection : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  string   Comment;
  string   ConnectionState;
  string   ConnectionType;
  string   DisplayType;
  string   LocalName;
  string   Name;
  boolean  Persistent;
  string   ProviderName;
  string   RemoteName;
  string   RemotePath;
  string   ResourceType;
  string   UserName;
};

Members

La classe Win32_NetworkConnection ha questi tipi di membri:

Proprietà

Proprietà

La classe Win32_NetworkConnection ha queste proprietà.

Accessmask

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32")

Elenco dei diritti di accesso al file o alla directory specificata detenuta dall'utente o dal gruppo per conto del quale viene restituita l'istanza. Nei volumi FAT il valore FULL_ACCESS viene invece restituito, a indicare che non è stata impostata alcuna sicurezza nell'oggetto .

FILE_READ_DATA (file) o FILE_LIST_DIRECTORY (directory) (1)

Concede il diritto di leggere i dati dal file. Per una directory, questo valore concede il diritto di elencare il contenuto della directory.

FILE_WRITE_DATA (file) o FILE_ADD_FILE (directory) (2)

Concede il diritto di scrivere dati nel file. Per una directory, questo valore concede il diritto di creare un file nella directory.

FILE_APPEND_DATA (file) o FILE_ADD_SUBDIRECTORY (4)

Concede il diritto di accodare i dati al file. Per una directory, questo valore concede il diritto di creare una sottodirectory.

FILE_READ_EA (8)

Concede il diritto di leggere gli attributi estesi.

FILE_WRITE_EA (16)

Concede il diritto di scrivere attributi estesi.

FILE_EXECUTE (file) o FILE_TRAVERSE (directory) (32)

Concede il diritto di eseguire un file. Per una directory, la directory può essere attraversata.

FILE_DELETE_CHILD (directory) (64)

Concede il diritto di eliminare una directory e tutti i file che contiene (i relativi elementi figlio), anche se i file sono di sola lettura.

FILE_READ_ATTRIBUTES (128)

Concede il diritto di leggere gli attributi del file.

FILE_WRITE_ATTRIBUTES (256)

Concede il diritto di modificare gli attributi del file.

DELETE (65536)

Concede l'accesso all'eliminazione.

READ_CONTROL (131072 )

Concede l'accesso in lettura al descrittore di sicurezza e al proprietario.

WRITE_DAC (262144)

Concede l'accesso in scrittura all'elenco di controllo di accesso discrezionale (DACL).

WRITE_OWNER (524288)

Assegna il proprietario di scrittura.

SYNCHRONIZE (1048576)

Sincronizza l'accesso e consente a un processo di attendere che un oggetto entri nello stato segnalato.

Didascalia

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.

Commento

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE|lpComment")

Commento fornito dal provider di rete.

ConnectionState

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MaxLen (20), MappingStrings ("Win32API| Strutture di gestione di rete | | USE_INFO_1 ui1_status")

Stato corrente della connessione di rete.

Connesso ("connesso ")

Errore ("Errore ")

Sospeso ("Sospeso ")

Disconnesso ("Disconnesso ")

Connessione ("connessione ")

Riconnessione ("Riconnessione")

ConnectionType

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE|dwScope")

Tipo di persistenza della connessione utilizzata per la connessione alla rete.

Connessione corrente ("connessione corrente")

Connessione persistente ("connessione persistente")

Descrizione

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Description")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

DisplayType

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE|dwDisplayType")

L'oggetto di rete deve essere visualizzato in un'interfaccia utente di esplorazione di rete.

Dominio ("Dominio ")

Generic ("Generic ")

Server ("Server")

Condividi ("Condividi ")

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.

Localname

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE|lpLocalName")

Nome locale del dispositivo di rete connesso.

Esempio: "c:\public"

Nome

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: key, Override ("Name"), MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE")

Nome della connessione di rete corrente. È la combinazione dei valori in RemoteName e LocalName.

Esempio: "\NTRELEASE (c:\public)"

Persistente

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Funzioni di rete di Windows | WNetEnumResource")

La connessione verrà riconnessa automaticamente dal sistema operativo nell'accesso successivo.

ProviderName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE|lpProvider")

Nome del provider proprietario della risorsa. Questa proprietà può essere NULL se il nome del provider è sconosciuto.

RemoteName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE|lpRemoteName")

Nome della risorsa di rete remota per una risorsa di rete. Per una connessione corrente o permanente, RemoteName contiene il nome di rete associato al nome del valore nella proprietà LocalName . Il nome in RemoteName deve seguire le convenzioni di denominazione del provider di rete.

Esempio: "\\NTRELEASE"

RemotePath

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE|lpRemoteName")

Percorso completo della risorsa di rete.

Esempio: "\\infosrv1\public"

ResourceType

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di rete Di Windows | NETRESOURCE|dwType")

Tipo di risorsa a cui enumerare o connettersi.

Disco ("Disco")

Stampa ("Stampa")

Any ("Any")

Status

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", "Degraded" 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, ricaricando un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutto questo lavoro è 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 ")

Danneggiato ("danneggiato ")

Sconosciuto ("Sconosciuto ")

Pred Fail ("Pred Fail ")

Avvio ("Avvio ")

Arresto ("arresto ")

Servizio ("Servizio ")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto")

Lost Comm ("Lost Comm")

UserName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Funzioni di rete di Windows | WNetGetUser")

Nome utente o nome utente predefinito usato per stabilire una connessione di rete.

Esempio: "SYSTEM"

Commenti

La classe Win32_NetworkConnection deriva da CIM_LogicalElement.

Esempio

Nell'esempio di codice VBScript seguente vengono recuperate informazioni sulla connessione di rete locale.

On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\Root\CIMv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_NetworkConnection",,48)
For Each objItem in colItems
    Wscript.Echo "AccessMask: " & objItem.AccessMask
    Wscript.Echo "Caption: " & objItem.Caption
    Wscript.Echo "Comment: " & objItem.Comment
    Wscript.Echo "ConnectionState: " & objItem.ConnectionState
    Wscript.Echo "ConnectionType: " & objItem.ConnectionType
    Wscript.Echo "Description: " & objItem.Description
    Wscript.Echo "DisplayType: " & objItem.DisplayType
    Wscript.Echo "InstallDate: " & objItem.InstallDate
    Wscript.Echo "LocalName: " & objItem.LocalName
    Wscript.Echo "Name: " & objItem.Name
    Wscript.Echo "Persistent: " & objItem.Persistent
    Wscript.Echo "ProviderName: " & objItem.ProviderName
    Wscript.Echo "RemoteName: " & objItem.RemoteName
    Wscript.Echo "RemotePath: " & objItem.RemotePath
    Wscript.Echo "ResourceType: " & objItem.ResourceType
    Wscript.Echo "Status: " & objItem.Status
    Wscript.Echo "UserName: " & objItem.UserName
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

Condividi tramite

classe Win32_NetworkConnection

Sintassi

Members

Proprietà

Commenti

Esempio

Requisiti

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive