LocalComputer コレクション
カタログにアクセスするコンピューターに対応する 1 つのオブジェクトが含まれます。 このオブジェクトは、コンピューター レベルの設定情報を保持します。 COMAdminCatalog クラスから作成されたオブジェクトに対して Connect メソッドを呼び出すと、LocalComputer コレクション内のオブジェクトには、カタログにアクセスするリモート コンピューターに関する情報が含まれます。
このコレクションは、COMAdminCatalogCollection オブジェクトの Add メソッドと Remove メソッドをサポートしていません。
メンバー
LocalComputer コレクションは IUnknown インターフェイスから継承されますが、追加のメンバーはありません。
関連コレクション
このコレクションから次のいずれかのコレクションに移動できます。
このコレクションには、次のコレクションから移動できます。
プロパティ
コレクション内の COMAdminCatalogObject オブジェクトでは、次のプロパティがサポートされています。
- ApplicationProxyRSN
- CISEnabled
- DCOMEnabled
- DefaultAuthenticationLevel
- DefaultImpersonationLevel
- DefaultToInternetPorts
- 説明
- DSPartitionLookupEnabled
- InternetPortsListed
- IsRouter
- LoadBalancingCLSID
- LocalPartitionLookupEnabled
- 名前
- OperatingSystem
- PartitionsEnabled
- ポート
- ResourcePoolingEnabled
- RPCProxyEnabled
- SecureReferencesEnabled
- SecurityTrackingEnabled
- SRPActivateAsActivatorChecks
- SRPRunningObjectChecks
- TransactionTimeout
ApplicationProxyRSN
| 入力 | 値 |
|---|---|
| 説明 | 既定では、アプリケーション プロキシによって使用されるリモート サーバー名。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
CISEnabled
| 入力 | 値 |
|---|---|
| 説明 | COM インターネット サービスが有効かどうかを示します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
DCOMEnabled
| 入力 | 値 |
|---|---|
| 説明 | コンピューターで DCOM を有効にするには、True に設定します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows 2000 |
DefaultAuthenticationLevel
| 入力 | 値 |
|---|---|
| 説明 | [認証] が [既定] に設定されているアプリケーションで使用される認証レベル。 値は、リモート プロシージャ コール (RPC) 認証設定に対応します。 |
| Access | ReadWrite |
| Type | Long Possible values:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6) |
| Default | COMAdminAuthenticationConnect (2) |
| 最小システム | Windows 2000 |
Note
COMAdminAuthenticationDefault は、COM が CoInitializeSecurity を呼び出すときに COMAdminAuthenticationConnect にマップされます。 数値ではなく、列挙型で定数を使用することをお勧めします。
DefaultImpersonationLevel
| 入力 | 値 |
|---|---|
| 説明 | 権限借用レベルが設定されていない場合に許可します。 |
| Access | ReadWrite |
| Type | Long 可能な値:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4) |
| Default | COMAdminImpersonationIdentify (2) |
| 最小システム | Windows 2000 |
Note
数値ではなく、列挙で定数を使用することをお勧めします。
DefaultToInternetPorts
| 入力 | 値 |
|---|---|
| 説明 | 提供されるポートの既定の種類をインターネット (True) またはイントラネット (False) にするかどうかを指定します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
説明
| 入力 | 値 |
|---|---|
| 説明 | コンピューターの説明。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
DSPartitionLookupEnabled
| 入力 | 値 |
|---|---|
| 説明 | パーティション マッピングのユーザーがドメイン ストアにチェックインされているかどうかを示します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows Server 2003 |
InternetPortsListed
| 入力 | 値 |
|---|---|
| 説明 | [ポート] プロパティに一覧表示されているポートをインターネット (True) またはイントラネット (False) に使用するかどうかを指定します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
IsRouter
| 入力 | 値 |
|---|---|
| 説明 | コンピューターがコンポーネント負荷分散 (CLB) サービスのルーターである場合は True に設定します。 このプロパティは、コンポーネント負荷分散サービスが現在コンピューターにインストールされている場合にのみ True に設定できます。それ以外の場合は、COMADMIN_E_REQUIRES_DIFFERENT_PLATFORMでエラーが発生します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
このプロパティが True に設定されている場合、CLB サーバーが構成され、起動時に開始されます。 サーバーがまだ存在しない場合、サーバーは ApplicationCluster コレクションに追加されます。
LoadBalancingCLSID
| 入力 | 値 |
|---|---|
| 説明 | バランスを取るオブジェクトの CLSID。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | NULL |
| 最小システム | Windows XP |
LocalPartitionLookupEnabled
| 入力 | 値 |
|---|---|
| 説明 | パーティション マッピングのユーザーがローカル ストアにチェックインされるかどうかを示します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows Server 2003 |
名前
| 入力 | 値 |
|---|---|
| 説明 | コンピューターの名前です。 文字列の先頭と末尾に余分なスペースが取り除かれます。このプロパティは、このコレクションのオブジェクトで Key または Name プロパティ メソッドが呼び出されたときに返されます。 |
| Access | WriteOnce |
| Type | 文字列型 |
| Default | "マイ コンピューター" |
| 最小システム | Windows 2000 |
OperatingSystem
| 入力 | 値 |
|---|---|
| 説明 | ローカル コンピューターにインストールされているオペレーティング システム。 |
| Access | ReadWrite |
| Type | Long Possible values:COMAdminOSNotInitialized (0)COMAdminOSWindows3_1(1)COMAdminOSWindows9x (2)COMAdminOSWindows2000 (3)COMAdminOSWindows2000AdvancedServer (4)COMAdminOSWindows2000Unknown (5)COMAdminOSUnknown () 6)COMAdminOSWindowsXPPersonal (11)COMAdminOSWindowsXPProfessional (12)COMAdminOSWindowsNETStandardServer (13)COMAdminOSWindowsNETEnterpriseServer (14)COMAdminOSWindowsNETDatacenterServer (15)COMAdminOSWindowsNETWebServer (16) |
| Default | COMAdminOSNotInitialized (0) |
| 最小システム | Windows 2000 |
PartitionsEnabled
| 入力 | 値 |
|---|---|
| 説明 | COM+ パーティションをローカル コンピューターで使用できるかどうかを示します。 このプロパティが False の場合、COM+ パーティションを使用しようとするとエラーが発生します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows Server 2003 |
Port
| 入力 | 値 |
|---|---|
| 説明 | InternetPortsListed プロパティに応じて、インターネットまたはイントラネットで使用されるポートを記述する文字列。たとえば、"500-599: 600-800" などです。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
ResourcePoolingEnabled
| 入力 | 値 |
|---|---|
| 説明 | リソース ディスペンサーの使用を有効にします。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows 2000 |
RPCProxyEnabled
| 入力 | 値 |
|---|---|
| 説明 | RPC IIS プロキシが有効かどうかを制御します。 RPC IIS プロキシは、IIS から RPC メカニズムへの呼び出しを転送するために IIS と組み合わせて使用され、CISEnabled を True に設定することで有効になる COM インターネット サービスのコア部分の 1 つです。 RPCProxyEnabled の詳細については、「 HTTP RPC セキュリティ」を参照してください。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
SecureReferencesEnabled
| 入力 | 値 |
|---|---|
| 説明 | IUnknown::AddRef メソッドと IUnknown::Release メソッドのクロスプロセス呼び出しをセキュリティで保護する DCOM コンピューターでを適用します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
SecurityTrackingEnabled
| 入力 | 値 |
|---|---|
| 説明 | オブジェクトでセキュリティ追跡が有効になっている場合は、True に設定します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows 2000 |
SRPActivateAsActivatorChecks
| 入力 | 値 |
|---|---|
| 説明 | ソフトウェア制限ポリシー (SRP) がアクティブ化のアクティブ化接続を処理する方法を決定します。 True に設定すると、サーバー オブジェクト用に構成された SRP 信頼レベルがクライアント オブジェクトの SRP 信頼レベルと比較され、より高い (より厳格な) 信頼レベルがサーバー オブジェクトの実行に使用されます。 False に設定すると、サーバー オブジェクトは、サーバーが構成されている SRP 信頼レベルに関係なく、クライアント オブジェクトの SRP 信頼レベルで実行されます。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows XP |
SRPRunningObjectChecks
| 入力 | 値 |
|---|---|
| 説明 | ソフトウェア制限ポリシー (SRP) が既存のプロセスへの試行された接続を処理する方法を決定します。 False に設定すると、実行中のオブジェクトへの接続試行は、適切な SRP 信頼レベルのチェックされません。 True に設定した場合、実行中のオブジェクトは、クライアント オブジェクトと等しい (より厳格な) SRP 信頼レベルを持っている必要があります。 たとえば、無制限 SRP 信頼レベルのクライアント オブジェクトは、許可されていない SRP 信頼レベルの実行中のオブジェクトに接続できません。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows XP |
TransactionTimeout
| 入力 | 値 |
|---|---|
| 説明 | トランザクション内で多数の操作を実行している場合は、十分な値 (秒単位) に設定する必要があります。 既定のタイムアウト期間は 60 秒で、最大タイムアウト期間は 3600 秒 (1 時間) です。 このプロパティを 0 に設定すると、トランザクションのタイムアウトが無効になります。 このプロパティは、Components コレクションの ComponentTransactionTimeout プロパティを使用して、個々の コンポーネント によってオーバーライドできます。 |
| Access | ReadWrite |
| Type | Long (0 から 3600) |
| Default | 60 |
| 最小システム | Windows 2000 |
例
次の Microsoft Visual Basic の例では、リモート コンピューターに接続し、リモート コンピューターの LocalComputer コレクションを使用して SecurityTrackingEnabled プロパティを取得する方法を示します。 この例を使用するには、Visual Basic プロジェクトへの参照として COM+ 管理 タイプ ライブラリを追加します。
Function RemoteComputerConnect(strComputer As String _
) As Boolean ' Return False if any errors occur.
RemoteComputerConnect = False ' Initialize the function.
On Error GoTo My_Error_Handler ' Initialize error handling.
Dim boolSTE As Boolean
Dim objCatalog As COMAdminCatalog
Dim objRemoteRootColl As COMAdminCatalogCollection
Dim objRemoteComputerColl As COMAdminCatalogCollection
Dim objRemoteComputerItem As COMAdminCatalogObject
Set objCatalog = CreateObject("COMAdmin.COMAdminCatalog")
Set objRemoteRootColl = objCatalog.Connect(strComputer)
Set objRemoteComputerColl = objRemoteRootColl.GetCollection( _
"LocalComputer", objRemoteRootColl.Name)
objRemoteComputerColl.Populate
Set objRemoteComputerItem = objRemoteComputerColl.Item(0)
boolSTE = objRemoteComputerItem.Value("SecurityTrackingEnabled")
If boolSTE Then
MsgBox "Security Tracking is enabled on " & strComputer
Else
MsgBox "Security Tracking is NOT enabled on " & strComputer
End If
Set objRemoteComputerItem = Nothing
Set objRemoteComputerColl = Nothing
Set objRemoteRootColl = Nothing
Set objCatalog = Nothing
RemoteComputerConnect = True ' Successful end to procedure
Exit Function
My_Error_Handler: ' Replace with specific error handling.
MsgBox "Error # " & Err.Number & " (Hex: " & Hex(Err.Number) _
& ")" & vbNewLine & Err.Description
Set objRemoteComputerItem = Nothing
Set objRemoteComputerColl = Nothing
Set objRemoteRootColl = Nothing
Set objCatalog = Nothing
End Function
関数を使用するには、リモート コンピューターの名前に文字列値を指定します。 次の Visual Basic コードは、"RemoteComputerName" という名前のコンピューターに接続する方法を示しています。
Sub Main()
If Not RemoteComputerConnect("RemoteComputerName") Then
MsgBox "RemoteComputerConnect failed."
End If
End Sub
関連項目