Win32_NetworkConnection 類別

發行項
06/12/2023

Win32_NetworkConnectionWMI 類別代表 Windows 型環境中的作用中網路連線。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。屬性和方法依字母順序排列，而非 MOF 順序。

語法

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

成員

Win32_NetworkConnection類別具有下列類型的成員：

屬性

屬性

Win32_NetworkConnection類別具有這些屬性。

AccessMask

資料類型： uint32
存取類型：唯讀
限定詞：架構 (「Win32」)

代表實例傳回之使用者或群組所持有之指定檔案或目錄的存取權限清單。在 FAT 磁片區上，會改為傳回 FULL_ACCESS 值，表示物件上未設定任何安全性。

FILE_READ_DATA (檔案) 或FILE_LIST_DIRECTORY (目錄) (1)

授與從檔案讀取資料的許可權。針對目錄，此值會授與列出目錄內容的許可權。

FILE_WRITE_DATA (檔案) 或FILE_ADD_FILE (目錄) (2)

授與將資料寫入檔案的許可權。針對目錄，此值會授與在目錄中建立檔案的許可權。

FILE_APPEND_DATA (檔案) 或 FILE_ADD_SUBDIRECTORY ( 4)

授與將資料附加至檔案的許可權。針對目錄，此值會授與建立子目錄的許可權。

FILE_READ_EA (8)

授與讀取擴充屬性的許可權。

FILE_WRITE_EA (16)

授與寫入擴充屬性的許可權。

FILE_EXECUTE (檔案) 或FILE_TRAVERSE (目錄) ( 32)

授與執行檔案的許可權。對於目錄，可以周遊目錄。

FILE_DELETE_CHILD (目錄) ( 64)

授與刪除目錄的許可權及其包含的所有檔案， (其子系) ，即使檔案是唯讀的。

FILE_READ_ATTRIBUTES (128)

授與讀取檔案屬性的許可權。

FILE_WRITE_ATTRIBUTES (256)

授與變更檔案屬性的許可權。

DELETE (65536)

授與刪除存取權。

READ_CONTROL (131072)

授與安全性描述項和擁有者的讀取權限。

WRITE_DAC (262144)

(DACL) 授與任意存取控制清單的寫入權限。

WRITE_OWNER (524288)

指派寫入擁有者。

同步處理 (1048576)

同步存取，並允許進程等候物件進入訊號狀態。

標題

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (64) 、 DisplayName (「Caption」)

物件的簡短文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

註解

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE|lpComment「)

網路提供者所提供的批註。

ConnectionState

資料類型：字串
存取類型：唯讀
限定詞：MaxLen (20) 、MappingStrings (「Win32API|網路管理結構 || USE_INFO_1ui1_status「)

網路連線的目前狀態。

已連線 (「已連線」)

錯誤 (「錯誤」)

暫停 (「Paused」)

已中斷 連線 (「已中斷連線」)

連線 (「連線」)

重新連線 (「重新連線」)

ConnectionType

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE|dwScope「)

用於連線到網路的連線持續性類型。

目前連線 (「目前連線 」)

持續性連線 (「持續性連線」)

說明

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Description」)

物件的文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

DisplayType

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE|dwDisplayType「)

網路物件應該會顯示在網路流覽使用者介面中。

網域 (「網域」)

泛型 (「Generic」)

伺服器 (「Server」)

共用 (「共用」)

InstallDate

資料類型： datetime
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)

指出何時安裝物件。缺少值並不表示未安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

LocalName

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE|lpLocalName「)

連線網路裝置的本機名稱。

範例：「c：\public」

名稱

資料類型：字串
存取類型：唯讀
限定詞：機碼、覆寫 (「Name」) 、 MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE「)

目前網路連線的名稱。它是 RemoteName 和 LocalName中的值組合。

範例：「\\NTRELEASE (c：\public) 」

持續

資料類型： 布林值
存取類型：唯讀
限定詞： MappingStrings (「Win32API|Windows 網路功能 |WNetEnumResource「)

下次登入時，作業系統會自動重新連線。

ProviderName

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE|lpProvider「)

擁有資源的提供者名稱。如果提供者名稱不明，這個屬性可以是 Null 。

RemoteName

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE|lpRemoteName「)

網路資源的遠端網路資源名稱。針對目前或持續性連線， RemoteName 包含與 LocalName 屬性中值名稱相關聯的網路名稱。 RemoteName中的名稱必須遵循網路提供者的命名慣例。

範例：「\\NTRELEASE」

[RemotePath]

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE|lpRemoteName「)

網路資源的完整路徑。

範例：「\\infosrv1\public」

ResourceType

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|Windows 網路結構 |NETRESOURCE|dwType「)

要列舉或連線的資源類型。

磁片 (「磁片」)

列印 (「Print」)

任何 (「任何」)

狀態

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (10) 、 DisplayName (「Status」)

表示物件目前狀態的字串。您可以定義作業和非操作狀態。作業狀態可以包括「OK」、「已降級」和「Pred Fail」。「預先失敗」表示元素正常運作，但正在預測失敗 (例如，已啟用 SMART 的硬碟) 。

非操作狀態可以包含「錯誤」、「啟動」、「停止」和「服務」。「服務」可以在磁片鏡像重新儲存期間套用、重載使用者許可權清單或其他系統管理工作。並非所有這類工作都處於線上狀態，但 Managed 元素不是「確定」，也不是在其他其中一種狀態。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定 (「確定」)

錯誤 (「錯誤」)

降級 (「降級」)

未知 (「未知」)

Pred Fail (「預先失敗」)

starting (「Starting」)

停止 (「停止」)

服務 (「Service」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

無連絡人 (「無連絡人」)

Lost Comm (「Lost Comm」)

使用者名稱

資料類型：字串
存取類型：唯讀
限定詞： MappingStrings (「Win32API|Windows 網路功能 |WNetGetUser「)

使用者名稱或用來建立網路連線的預設使用者名稱。

範例：「SYSTEM」

備註

Win32_NetworkConnection類別衍生自CIM_LogicalElement。

範例

下列 VBScript 程式碼範例會擷取區域網路連線的相關資訊。

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

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
命名空間	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

CIM_LogicalElement
作業系統類別

共用方式為

Win32_NetworkConnection 類別

語法

成員

屬性

備註

範例

規格需求

另請參閱

意見反應

其他資源