Win32_NetworkConnection クラス
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)
-
書き込み所有者を割り当てます。
-
SYNCHRONIZE (1048576)
-
アクセスを同期し、オブジェクトがシグナル状態になるまでプロセスが待機できるようにします。
Caption
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (64)、 DisplayName ("Caption")
オブジェクトの短いテキストの説明。
このプロパティは、 CIM_ManagedSystemElementから継承されます。
解説
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpComment")
ネットワーク プロバイダーによって提供されるコメント。
ConnectionState
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (20)、MappingStrings ("Win32API|ネットワーク管理構造|| USE_INFO_1ui1_status")
ネットワーク接続の現在の状態。
接続済み ("接続済み")
エラー ("Error")
一時停止 ("一時停止")
切断済み ("Disconnected")
接続 ("接続")
再接続 ("再接続")
ConnectionType
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|dwScope")
ネットワークへの接続に使用される接続の永続化の種類。
現在の接続 ("現在の接続")
永続的な接続 ("永続的な接続")
説明
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: DisplayName ("Description")
オブジェクトのテキストの説明。
このプロパティは、 CIM_ManagedSystemElementから継承されます。
DisplayType
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|dwDisplayType")
ネットワーク オブジェクトは、ネットワーク 参照ユーザー インターフェイスに表示する必要があります。
ドメイン ("Domain")
Generic ("Generic")
サーバー ("Server")
共有 ("共有")
InstallDate
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")
オブジェクトがインストールされた日時を示します。 値がない場合、オブジェクトがインストールされていないことを示すわけではありません。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
Localname
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpLocalName")
接続されているネットワーク デバイスのローカル名。
例: "c:\public"
Name
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: key、 Override ("Name")、 MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE")
現在のネットワーク接続の名前。 RemoteName と LocalName の値の組み合わせです。
例: "\\NTRELEASE (c:\public)"
永続的
-
データ型: boolean
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク関数|WNetEnumResource")
接続は、次のログオン時にオペレーティング システムによって自動的に再接続されます。
ProviderName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpProvider")
リソースを所有するプロバイダーの名前。 プロバイダー名が不明な場合、このプロパティは NULL にすることができます。
RemoteName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpRemoteName")
ネットワーク リソースのリモート ネットワーク リソース名。 現在または永続的な接続の場合、 RemoteName には LocalName プロパティの値の名前に関連付けられたネットワーク名が含まれます。 RemoteName の名前は、ネットワーク プロバイダーの名前付け規則に従う必要があります。
例: "\\NTRELEASE"
[RemotePath]
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpRemoteName")
ネットワーク リソースへの完全なパス。
例: "\\infosrv1\public"
ResourceType
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|dwType")
列挙または接続するリソースの種類。
ディスク ("Disk")
印刷 ("Print")
Any ("Any")
状態
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (10)、 DisplayName ("Status")
オブジェクトの現在の状態を示す文字列。 操作状態と非運用状態を定義できます。 運用状態には、"OK"、"機能低下"、"Pred Fail" を含めることができます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハード ディスク ドライブなど) を予測していることを示します。
非運用状態には、"エラー"、"開始中"、"停止中"、および "サービス" が含まれる場合があります。 "サービス" は、ディスクミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。 このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
次の値があります。
OK ("OK")
エラー ("Error")
機能低下 ("Degraded")
不明 ("不明")
Pred Fail ("Pred Fail")
開始 中 ("Starting")
停止 中 ("停止中")
サービス ("Service")
ストレス ( "ストレス")
NonRecover ("NonRecover")
連絡先なし ("連絡先なし")
Lost Comm ("Lost Comm")
UserName
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: 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 |
|
| [DLL] |
|
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示