classe Win32_NetworkConnection
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à
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 |
|
| DLL |
|
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per