Freigeben über

LocalComputer-Sammlung

  • Artikel

Enthält ein einzelnes Objekt, das dem Computer entspricht, auf dessen Katalog Sie zugreifen. Dieses Objekt enthält Einstellungen auf Computerebene. Wenn Sie die Connect-Methode für ein Objekt aufrufen, das aus der COMAdminCatalog-Klasse erstellt wurde, enthält das Objekt in der LocalComputer-Auflistung Informationen zu dem Remotecomputer, auf dessen Katalog Sie zugreifen.

Diese Auflistung unterstützt die Add- und Remove-Methoden des COMAdminCatalogCollection-Objekts nicht.

Member

Die LocalComputer-Auflistung erbt von der IUnknown-Schnittstelle , verfügt aber nicht über zusätzliche Member.

Sie können von dieser Sammlung zu einer der folgenden Sammlungen navigieren:

Sie können aus den folgenden Sammlungen zu dieser Sammlung navigieren:

Eigenschaften

Die folgenden Eigenschaften werden vom COMAdminCatalogObject-Objekt innerhalb der Auflistung unterstützt:

ApplicationProxyRSN

Eingabe Wert
BESCHREIBUNG Remoteservername, der standardmäßig von Anwendungsproxys verwendet wird.
Access ReadWrite
type String
Standard ""
Mindestsystem Windows 2000

 

CISEnabled

Eingabe Wert
BESCHREIBUNG Gibt an, ob COM-Internetdienste aktiviert ist.
Access ReadWrite
type Bool
Standard Falsch
Mindestsystem Windows 2000

 

DCOMEnabled

Eingabe Wert
BESCHREIBUNG Legen Sie auf True fest, um DCOM auf dem Computer zu aktivieren.
Access ReadWrite
type Bool
Standard True
Mindestsystem Windows 2000

 

DefaultAuthenticationLevel

Eingabe Wert
BESCHREIBUNG Authentifizierungsebene, die von Anwendungen verwendet wird, für die die Authentifizierung auf Standard festgelegt ist. Die Werte entsprechen den RPC-Authentifizierungseinstellungen (Remote Procedure Call).
Access ReadWrite
type Long Mögliche Werte:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
Standard COMAdminAuthenticationConnect (2)
Mindestsystem Windows 2000

 

Hinweis

COMAdminAuthenticationDefault wird COMAdminAuthenticationConnect zugeordnet, wenn COM CoInitializeSecurity aufruft. Es wird empfohlen, die Konstanten in der Enumeration und nicht die numerischen Werte zu verwenden.

 

DefaultImpersonationLevel

Eingabe Wert
BESCHREIBUNG Identitätswechselebene zuzulassen, wenn sie nicht festgelegt ist.
Access ReadWrite
type Long Mögliche Werte:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
Standard COMAdminImpersonationIdentify (2)
Mindestsystem Windows 2000

 

Hinweis

Es wird empfohlen, die Konstanten in der Enumeration und nicht die numerischen Werte zu verwenden.

 

DefaultToInternetPorts

Eingabe Wert
BESCHREIBUNG Bestimmt, ob der Standardtyp des bereitgestellten Ports Internet (True) oder Intranet (False) sein soll.
Access ReadWrite
type Bool
Standard Falsch
Mindestsystem Windows 2000

 

BESCHREIBUNG

Eingabe Wert
BESCHREIBUNG Eine Beschreibung des Computers.
Access ReadWrite
type String
Standard ""
Mindestsystem Windows 2000

 

DSPartitionLookupEnabled

Eingabe Wert
BESCHREIBUNG Gibt an, ob der Benutzer der Partitionszuordnungen in den Domänenspeicher eingecheckt ist.
Access ReadWrite
type Bool
Standard True
Mindestsystem Windows Server 2003

 

InternetPortsListed

Eingabe Wert
BESCHREIBUNG Bestimmt, ob die in der Ports-Eigenschaft aufgeführten Ports für das Internet (True) oder für das Intranet (False) verwendet werden sollen.
Access ReadWrite
type Bool
Standard Falsch
Mindestsystem Windows 2000

 

IsRouter

Eingabe Wert
BESCHREIBUNG Legen Sie auf True fest, wenn der Computer ein Router für den CLB-Dienst (Component Load Balancing) ist. Diese Eigenschaft kann nur dann auf True festgelegt werden, wenn der Komponentenlastenausgleichsdienst derzeit auf dem Computer installiert ist. andernfalls fehler mit COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM.
Access ReadWrite
type Bool
Standard Falsch
Mindestsystem Windows 2000

 

Wenn diese Eigenschaft auf True festgelegt ist, wird der CLB-Server konfiguriert und beim Start gestartet. Der Server wird der ApplicationCluster-Auflistung hinzugefügt, wenn er noch nicht vorhanden ist.

LoadBalancingCLSID

Eingabe Wert
BESCHREIBUNG Die CLSID des zu balancierenden Objekts.
Access ReadWrite
type String
Standard NULL
Mindestsystem Windows XP

 

LocalPartitionLookupEnabled

Eingabe Wert
BESCHREIBUNG Gibt an, ob der Benutzer der Partitionszuordnungen im lokalen Speicher eingecheckt ist.
Access ReadWrite
type Bool
Standard True
Mindestsystem Windows Server 2003

 

Name

Eingabe Wert
BESCHREIBUNG Der Name des Computers. Zusätzliche Leerzeichen am Anfang und Ende der Zeichenfolge werden entfernt. Diese Eigenschaft wird zurückgegeben, wenn die Key- oder Name-Eigenschaftsmethode für ein Objekt dieser Auflistung aufgerufen wird.
Access WriteOnce
type String
Standard "Arbeitsplatz"
Mindestsystem Windows 2000

 

OperatingSystem

Eingabe Wert
BESCHREIBUNG Das auf dem lokalen Computer installierte Betriebssystem.
Access ReadWrite
type Long Mögliche Werte: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)
Standard COMAdminOSNotInitialized (0)
Mindestsystem Windows 2000

 

PartitionenEnabled

Eingabe Wert
BESCHREIBUNG Gibt an, ob COM+-Partitionen auf dem lokalen Computer verwendet werden können. Wenn diese Eigenschaft False ist, führt jeder Versuch, COM+-Partitionen zu verwenden, zu einem Fehler.
Access ReadWrite
type Bool
Standard Falsch
Mindestsystem Windows Server 2003

 

Ports

Eingabe Wert
BESCHREIBUNG Eine Zeichenfolge, die Ports beschreibt, die abhängig von der InternetPortsListed-Eigenschaft entweder für die Internet- oder Intranetnutzung geeignet sind. Beispiel: "500-599: 600-800".
Access ReadWrite
type String
Standard ""
Mindestsystem Windows 2000

 

ResourcePoolingEnabled

Eingabe Wert
BESCHREIBUNG Ermöglicht die Verwendung von Ressourcenspendern.
Access ReadWrite
type Bool
Standard True
Mindestsystem Windows 2000

 

RPCProxyEnabled

Eingabe Wert
BESCHREIBUNG Steuert, ob der RPC IIS-Proxy aktiviert ist. Der RPC IIS-Proxy wird in Verbindung mit IIS verwendet, um Aufrufe an den RPC-Mechanismus von IIS weiterzuleiten. Er ist einer der Kernelemente von COM-Internetdiensten, die durch Festlegen von CISEnabled auf True aktiviert wird. Weitere Informationen zu RPCProxyEnabled finden Sie unter HTTP RPC-Sicherheit.
Access ReadWrite
type Bool
Standard Falsch
Mindestsystem Windows 2000

 

SecureReferencesEnabled

Eingabe Wert
BESCHREIBUNG Erzwingt auf DCOM-Computern, dass prozessübergreifende Aufrufe der Methoden IUnknown::AddRef und IUnknown::Release gesichert sind.
Access ReadWrite
type Bool
Standard Falsch
Mindestsystem Windows 2000

 

SecurityTrackingEnabled

Eingabe Wert
BESCHREIBUNG Legen Sie auf True fest, wenn die Sicherheitsnachverfolgung für Objekte aktiviert ist.
Access ReadWrite
type Bool
Standard True
Mindestsystem Windows 2000

 

SRPActivateAsActivatorChecks

Eingabe Wert
BESCHREIBUNG Bestimmt, wie die Softwareeinschränkungsrichtlinie (Software Restriction Policy, SRP) Verbindungen mit aktivierungsbasierter Aktivierung behandelt. Bei Festlegung auf True wird die SRP-Vertrauensstufe, die für das Serverobjekt konfiguriert ist, mit der SRP-Vertrauensstufe des Clientobjekts verglichen, und die höhere (strengere) Vertrauensebene wird zum Ausführen des Serverobjekts verwendet. Wenn dieser Wert auf False festgelegt ist, wird das Serverobjekt mit der SRP-Vertrauensstufe des Clientobjekts ausgeführt, unabhängig von der SRP-Vertrauensstufe, mit der der Server konfiguriert ist.
Access ReadWrite
type Bool
Standard True
Mindestsystem Windows XP

 

SRPRunningObjectChecks

Eingabe Wert
BESCHREIBUNG Bestimmt, wie die Softwareeinschränkungsrichtlinie (Software Restriction Policy, SRP) versuchte Verbindungen mit vorhandenen Prozessen verarbeitet. Wenn dieser Wert auf False festgelegt ist, werden Versuche, eine Verbindung mit ausgeführten Objekten herzustellen, nicht auf geeignete SRP-Vertrauensstufen überprüft. Wenn dieser Wert auf True festgelegt ist, muss das ausgeführte Objekt eine gleiche oder eine höhere (strengere) SRP-Vertrauensstufe aufweisen als das Clientobjekt. Beispielsweise kann ein Clientobjekt mit einer uneingeschränkten SRP-Vertrauensstufe keine Verbindung mit einem ausgeführten Objekt mit einer Nicht zulässigen SRP-Vertrauensstufe herstellen.
Access ReadWrite
type Bool
Standard True
Mindestsystem Windows XP

 

TransactionTimeout

Eingabe Wert
BESCHREIBUNG Sollte in Sekunden auf einen ausreichenden Wert festgelegt werden, wenn Sie zahlreiche Vorgänge innerhalb einer Transaktion ausführen. Der Standardtimeoutzeitraum beträgt 60 Sekunden, und der maximale Timeoutzeitraum beträgt 3600 Sekunden (1 Stunde). Wenn Sie diese Eigenschaft auf 0 festlegen, werden Transaktionstimeouts deaktiviert. Diese Eigenschaft kann von einzelnen Komponenten mit der ComponentTransactionTimeout-Eigenschaft der Components-Auflistung überschrieben werden.
Access ReadWrite
type Lang (0-3600)
Standard 60
Mindestsystem Windows 2000

 

Beispiel

Im folgenden Microsoft Visual Basic-Beispiel wird veranschaulicht, wie Sie eine Verbindung mit einem Remotecomputer herstellen und dessen SecurityTrackingEnabled-Eigenschaft mithilfe der LocalComputer-Sammlung des Remotecomputers abrufen. Um dieses Beispiel zu verwenden, fügen Sie die COM+-Admin-Typbibliothek als Verweis auf Ihr Visual Basic-Projekt hinzu.

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

Um die Funktion zu verwenden, geben Sie einen Zeichenfolgenwert für den Namen des Remotecomputers an. Der folgende Visual Basic-Code zeigt, wie Sie eine Verbindung mit dem Computer mit dem Namen "RemoteComputerName" herstellen.

Sub Main()
    If Not RemoteComputerConnect("RemoteComputerName") Then
        MsgBox "RemoteComputerConnect failed."
    End If
End Sub

Siehe auch

COM+-Verwaltungssammlungen