LocalComputer 컬렉션
카탈로그에 액세스하는 컴퓨터에 해당하는 단일 개체를 포함합니다. 이 개체는 컴퓨터 수준 설정 정보를 보유합니다. COMAdminCatalog 클래스에서 만든 개체에서 Connect 메서드를 호출하는 경우 LocalComputer 컬렉션의 개체에는 사용자가 액세스하는 카탈로그가 있는 원격 컴퓨터에 대한 정보가 포함됩니다.
이 컬렉션은 COMAdminCatalogCollection 개체의 Add 및 Remove 메서드를 지원하지 않습니다.
멤버
LocalComputer 컬렉션은 IUnknown 인터페이스에서 상속되지만 추가 멤버는 없습니다.
관련 컬렉션
이 컬렉션에서 다음 컬렉션으로 이동할 수 있습니다.
다음 컬렉션에서 이 컬렉션으로 이동할 수 있습니다.
속성
다음 속성은 컬렉션 내의 COMAdminCatalogObject 개체에서 지원됩니다.
- ApplicationProxyRSN
- CISEnabled
- DCOMEnabled
- DefaultAuthenticationLevel
- DefaultImpersonationLevel
- DefaultToInternetPorts
- 설명
- DSPartitionLookupEnabled
- InternetPortsListed
- IsRouter
- LoadBalancingCLSID
- LocalPartitionLookupEnabled
- 이름
- OperatingSystem
- PartitionsEnabled
- Ports
- ResourcePoolingEnabled
- RPCProxyEnabled
- SecureReferencesEnabled
- SecurityTrackingEnabled
- SRPActivateAsActivatorChecks
- SRPRunningObjectChecks
- TransactionTimeout
ApplicationProxyRSN
| 입력 | 값 |
|---|---|
| 설명 | 기본적으로 애플리케이션 프록시에서 사용하는 원격 서버 이름입니다. |
| Access | ReadWrite |
| Type | 문자열 |
| 기본값 | "" |
| 최소 시스템 | Windows 2000 |
CISEnabled
| 입력 | 값 |
|---|---|
| 설명 | COM Internet Services를 사용할 수 있는지 여부를 나타냅니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | False |
| 최소 시스템 | Windows 2000 |
DCOMEnabled
| 입력 | 값 |
|---|---|
| 설명 | 컴퓨터에서 DCOM을 사용하도록 설정하려면 True로 설정합니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | True |
| 최소 시스템 | Windows 2000 |
DefaultAuthenticationLevel
| 입력 | 값 |
|---|---|
| 설명 | 인증이 기본값으로 설정된 애플리케이션에서 사용하는 인증 수준입니다. 값은 RPC(원격 프로시저 호출) 인증 설정에 해당합니다. |
| Access | ReadWrite |
| 형식 | 가능한 긴 값:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6) |
| 기본값 | COMAdminAuthenticationConnect(2) |
| 최소 시스템 | Windows 2000 |
참고
COM에서 CoInitializeSecurity를 호출하면 COMAdminAuthenticationDefault가 COMAdminAuthenticationConnect에 매핑됩니다. 숫자 값이 아닌 열거형의 상수를 사용하는 것이 좋습니다.
DefaultImpersonationLevel
| 입력 | 값 |
|---|---|
| 설명 | 설정되지 않은 경우 허용하는 가장 수준입니다. |
| Access | ReadWrite |
| 형식 | 가능한 긴 값:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4) |
| 기본값 | COMAdminImpersonationIdentify (2) |
| 최소 시스템 | Windows 2000 |
참고
숫자 값이 아닌 열거형의 상수를 사용하는 것이 좋습니다.
DefaultToInternetPorts
| 입력 | 값 |
|---|---|
| Description | 제공된 포트의 기본 형식이 인터넷(True) 또는 인트라넷(False)인지 여부를 결정합니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | False |
| 최소 시스템 | Windows 2000 |
Description
| 입력 | 값 |
|---|---|
| Description | 컴퓨터에 대한 설명입니다. |
| Access | ReadWrite |
| Type | 문자열 |
| 기본값 | "" |
| 최소 시스템 | Windows 2000 |
DSPartitionLookupEnabled
| 입력 | 값 |
|---|---|
| Description | 파티션 매핑의 사용자가 도메인 저장소에 체크 인되었는지 여부를 나타냅니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | True |
| 최소 시스템 | Windows Server 2003 |
InternetPortsListed
| 입력 | 값 |
|---|---|
| Description | Ports 속성에 나열된 포트를 인터넷(True) 또는 인트라넷(False)에 사용할지 여부를 결정합니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | False |
| 최소 시스템 | Windows 2000 |
IsRouter
| 입력 | 값 |
|---|---|
| Description | 컴퓨터가 CLB(구성 요소 부하 분산) 서비스의 라우터인 경우 True로 설정합니다. 이 속성은 구성 요소 부하 분산 서비스가 현재 컴퓨터에 설치된 경우에만 True로 설정할 수 있습니다. 그렇지 않으면 COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM 오류가 발생합니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | False |
| 최소 시스템 | Windows 2000 |
이 속성을 True로 설정하면 CLB 서버가 구성되고 시작 시 시작됩니다. 서버가 아직 없는 경우 ApplicationCluster 컬렉션에 추가됩니다.
LoadBalancingCLSID
| 입력 | 값 |
|---|---|
| Description | 균형을 맞출 개체의 CLSID입니다. |
| Access | ReadWrite |
| Type | 문자열 |
| 기본값 | NULL |
| 최소 시스템 | Windows XP |
LocalPartitionLookupEnabled
| 입력 | 값 |
|---|---|
| Description | 파티션 매핑의 사용자가 로컬 저장소에 체크 인되는지 여부를 나타냅니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | True |
| 최소 시스템 | Windows Server 2003 |
속성
| 입력 | 값 |
|---|---|
| Description | 컴퓨터의 이름. 문자열의 시작과 끝에 있는 추가 공백이 제거됩니다. 이 속성은 이 컬렉션의 개체에서 Key 또는 Name 속성 메서드를 호출할 때 반환됩니다. |
| Access | WriteOnce |
| Type | 문자열 |
| 기본값 | "내 컴퓨터" |
| 최소 시스템 | Windows 2000 |
OperatingSystem
| 입력 | 값 |
|---|---|
| Description | 로컬 컴퓨터에 설치된 운영 체제입니다. |
| Access | ReadWrite |
| 형식 | 가능한 긴 값:COMAdminOSNotInitialized (0)COMAdminOSWindows3_1(1)COMAdminOSWindows9x (2)COMAdminOSWindows2000 (3)COMAdAdminOSWindows2000AdvancedServer (4)COMAdminOSWindows2000Unknown (5)COMAdminOSUnknown (6)COMAdminOSWindowsXPPersonal (11)COMAdminOSWindowsXPProfessional (12)COMAdminOSWindowsNETStandardServer (13)COMAdminOSWindowsNETEnterpriseServer (14)COMAdminOSWindowsNETDatacenterServer (15)COMAdminOSWindowsNETWebServer (16) |
| 기본값 | COMAdminOSNotInitialized (0) |
| 최소 시스템 | Windows 2000 |
PartitionsEnabled
| 입력 | 값 |
|---|---|
| Description | 로컬 컴퓨터에서 COM+ 파티션을 사용할 수 있는지 여부를 나타냅니다. 이 속성이 False이면 COM+ 파티션을 사용하려고 하면 오류가 발생합니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | False |
| 최소 시스템 | Windows Server 2003 |
포트
| 입력 | 값 |
|---|---|
| Description | InternetPortsListed 속성에 따라 인터넷 또는 인트라넷 사용용 포트를 설명하는 문자열입니다. 예: "500-599: 600-800". |
| Access | ReadWrite |
| Type | 문자열 |
| 기본값 | "" |
| 최소 시스템 | Windows 2000 |
ResourcePoolingEnabled
| 입력 | 값 |
|---|---|
| Description | 리소스 디스펜서를 사용할 수 있습니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | True |
| 최소 시스템 | Windows 2000 |
RPCProxyEnabled
| 입력 | 값 |
|---|---|
| Description | RPC IIS 프록시를 사용할 수 있는지 여부를 제어합니다. RPC IIS 프록시는 IIS와 함께 IIS에서 RPC 메커니즘에 대한 호출을 전달하는 데 사용되며 CISEnabled를 True로 설정하여 사용하도록 설정된 COM Internet Services의 핵심 부분 중 하나입니다. RPCProxyEnabled에 대한 자세한 내용은 HTTP RPC 보안을 참조하세요. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | False |
| 최소 시스템 | Windows 2000 |
SecureReferencesEnabled
| 입력 | 값 |
|---|---|
| Description | IUnknown::AddRef 및 IUnknown::Release 메서드에 대한 교차 프로세스 호출이 보호되는 DCOM 컴퓨터에서 를 적용합니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | False |
| 최소 시스템 | Windows 2000 |
SecurityTrackingEnabled
| 입력 | 값 |
|---|---|
| Description | 개체에서 보안 추적을 사용하도록 설정하면 True로 설정합니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | True |
| 최소 시스템 | Windows 2000 |
SRPActivateAsActivatorChecks
| 입력 | 값 |
|---|---|
| Description | SRP(소프트웨어 제한 정책)가 활성화자 연결로 활성화를 처리하는 방법을 결정합니다. True로 설정하면 서버 개체에 대해 구성된 SRP 신뢰 수준이 클라이언트 개체의 SRP 신뢰 수준과 비교되고 서버 개체를 실행하는 데 더 높은(더 엄격한) 신뢰 수준이 사용됩니다. False로 설정하면 서버가 구성된 SRP 신뢰 수준에 관계없이 서버 개체가 클라이언트 개체의 SRP 신뢰 수준으로 실행됩니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | True |
| 최소 시스템 | Windows XP |
SRPRunningObjectChecks
| 입력 | 값 |
|---|---|
| Description | SRP(소프트웨어 제한 정책)가 기존 프로세스에 대한 시도된 연결을 처리하는 방법을 결정합니다. False로 설정하면 실행 중인 개체에 연결하려는 시도가 적절한 SRP 신뢰 수준에 대해 확인되지 않습니다. True로 설정하면 실행 중인 개체의 SRP 신뢰 수준이 클라이언트 개체보다 같거나 높아야 합니다. 예를 들어 무제한 SRP 신뢰 수준이 있는 클라이언트 개체는 허용되지 않는 SRP 신뢰 수준을 사용하여 실행 중인 개체에 연결할 수 없습니다. |
| Access | ReadWrite |
| 형식 | Bool |
| 기본값 | True |
| 최소 시스템 | Windows XP |
TransactionTimeout
| 입력 | 값 |
|---|---|
| Description | 트랜잭션 내에서 여러 작업을 수행하는 경우 초 단위로 충분한 값으로 설정해야 합니다. 기본 제한 시간은 60초이고 최대 제한 시간은 3600초(1시간)입니다. 이 속성을 0으로 설정하면 트랜잭션 시간 초과가 비활성화됩니다. 이 속성은 Components 컬렉션의 ComponentTransactionTimeout 속성을 사용하여 개별 구성 요소 에서 재정의할 수 있습니다. |
| Access | ReadWrite |
| 형식 | Long(0-3600) |
| 기본값 | 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
추가 정보