Collection LocalComputer

Contient un objet unique qui correspond à l’ordinateur dont vous accédez au catalogue. Cet objet contient des informations sur les paramètres au niveau de l’ordinateur. si vous appelez la méthode Connecter sur un objet créé à partir de la classe COMAdminCatalog , l’objet de la collection LocalComputer contient des informations sur l’ordinateur distant dont vous accédez au catalogue.

Cette collection ne prend pas en charge les méthodes Add et Remove de l’objet COMAdminCatalogCollection .

Membres

La collection LocalComputer hérite de l’interface IUnknown , mais n’a pas de membres supplémentaires.

Vous pouvez naviguer à partir de cette collection vers l’un des regroupements suivants :

Vous pouvez accéder à cette collection à partir des regroupements suivants :

Propriétés

Les propriétés suivantes sont prises en charge par l’objet COMAdminCatalogObject dans la collection :

ApplicationProxyRSN

Entrée Valeur
Description Nom du serveur distant utilisé par les proxys d’application par défaut.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows 2000

CISEnabled

Entrée Valeur
Description Indique si les services Internet COM sont activés.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

DCOMEnabled

Entrée Valeur
Description Affectez la valeur true pour activer DCOM sur l’ordinateur.
Access Lecture/écriture
Type Bool
Default Vrai
Système minimal Windows 2000

DefaultAuthenticationLevel

Entrée Valeur
Description Niveau d’authentification utilisé par les applications dont l’authentification est définie sur par défaut. Les valeurs correspondent aux paramètres d’authentification de l’appel de procédure distante (RPC).
Access Lecture/écriture
Type Valeurs possibles longues : COMAdminAuthenticationDefault (0) COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2) COMAdminAuthenticationCall (3) COMAdminAuthenticationPacket (4) COMAdminAuthenticationIntegrity (5) COMAdminAuthenticationPrivacy (6)
Default COMAdminAuthenticationConnect (2)
Système minimal Windows 2000

Notes

COMAdminAuthenticationDefault est mappé à COMAdminAuthenticationConnect quand COM appelle CoInitializeSecurity. Il est recommandé d’utiliser les constantes dans l’énumération et non les valeurs numériques.

DefaultImpersonationLevel

Entrée Valeur
Description Niveau d’emprunt d’identité à autoriser si aucun n’est défini.
Access Lecture/écriture
Type Valeurs possibles longues : COMAdminImpersonationAnonymous (1) COMAdminImpersonationIdentify (2) COMAdminImpersonationImpersonate (3) COMAdminImpersonationDelegate (4)
Default COMAdminImpersonationIdentify (2)
Système minimal Windows 2000

Notes

Il est recommandé d’utiliser les constantes dans l’énumération, et non les valeurs numériques.

DefaultToInternetPorts

Entrée Valeur
Description Détermine si le type de port par défaut fourni doit être Internet (true) ou intranet (false).
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

Description

Entrée Valeur
Description Description de l’ordinateur.
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows 2000

DSPartitionLookupEnabled

Entrée Valeur
Description Indique si l’utilisateur des mappages de partition est archivé dans le magasin de domaines.
Access Lecture/écriture
Type Bool
Default Vrai
Système minimal Windows Server 2003

InternetPortsListed

Entrée Valeur
Description Détermine si les ports répertoriés dans la propriété ports doivent être utilisés pour Internet (true) ou pour l’intranet (false).
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

IsRouter

Entrée Valeur
Description Affectez la valeur true si l’ordinateur est un routeur pour le service d’équilibrage de charge des composants (CLB). Cette propriété ne peut être définie sur true que si le service d’équilibrage de charge de composant est actuellement installé sur l’ordinateur. Sinon, les erreurs avec comadmin _ E _ requièrent une _ _ plateforme différente.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

Si cette propriété est définie sur true, le serveur CLB est configuré et démarre au démarrage. Le serveur est ajouté à la collection ApplicationCluster si elle n’est pas déjà présente.

LoadBalancingCLSID

Entrée Valeur
Description CLSID de l’objet à équilibrer.
Access Lecture/écriture
Type String
Valeur par défaut NULL
Système minimal Windows XP

LocalPartitionLookupEnabled

Entrée Valeur
Description Indique si l’utilisateur des mappages de partition est archivé dans le magasin local.
Access Lecture/écriture
Type Bool
Default Vrai
Système minimal Windows Server 2003

Nom

Entrée Valeur
Description Nom de l’ordinateur. Les espaces supplémentaires au début et à la fin de la chaîne sont supprimés. Cette propriété est retournée lorsque la méthode de propriété Key ou Name est appelée sur un objet de cette collection.
Access WriteOnce
Type String
Valeur par défaut « Poste de travail »
Système minimal Windows 2000

OperatingSystem

Entrée Valeur
Description Le système d’exploitation installé sur l’ordinateur local.
Access Lecture/écriture
Type Valeurs possibles longues : 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)
Système minimal Windows 2000

PartitionsEnabled

Entrée Valeur
Description Indique si les partitions COM+ peuvent être utilisées sur l’ordinateur local. Si cette propriété a la valeur false, toute tentative d’utilisation de partitions COM+ génère une erreur.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows Server 2003

Ports

Entrée Valeur
Description Chaîne qui décrit les ports utilisés pour l’utilisation d’Internet ou de l’intranet, en fonction de la propriété InternetPortsListed ; par exemple, « 500-599:600-800 ».
Access Lecture/écriture
Type String
Valeur par défaut ""
Système minimal Windows 2000

ResourcePoolingEnabled

Entrée Valeur
Description Permet l’utilisation de redistributeurs de ressources.
Access Lecture/écriture
Type Bool
Default Vrai
Système minimal Windows 2000

RPCProxyEnabled

Entrée Valeur
Description Contrôle si le proxy IIS RPC est activé. Le proxy IIS RPC est utilisé conjointement avec IIS pour transférer les appels au mécanisme RPC depuis IIS et est l’un des principaux éléments des services Internet COM, qui est activé en affectant à CISEnabled la valeur true. Pour plus d’informations sur RPCProxyEnabled, consultez sécurité RPC http.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

SecureReferencesEnabled

Entrée Valeur
Description S’applique aux ordinateurs DCOM qui envoient des appels interprocessus aux méthodes IUnknown :: AddRef et IUnknown :: Release .
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

SecurityTrackingEnabled

Entrée Valeur
Description Affectez la valeur true si le suivi de sécurité est activé sur les objets.
Access Lecture/écriture
Type Bool
Default Vrai
Système minimal Windows 2000

SRPActivateAsActivatorChecks

Entrée Valeur
Description Détermine comment la stratégie de restriction logicielle (SRP) gère les connexions d’activation en tant qu’activateur. Si la valeur est true, le niveau de confiance SRP configuré pour l’objet serveur est comparé au niveau de confiance SRP de l’objet client et le niveau de confiance le plus élevé (plus rigoureux) est utilisé pour exécuter l’objet serveur. Si la valeur est false, l’objet serveur s’exécute avec le niveau de confiance SRP de l’objet client, quel que soit le niveau de confiance du SRP avec lequel le serveur est configuré.
Access Lecture/écriture
Type Bool
Default Vrai
Système minimal Windows XP

SRPRunningObjectChecks

Entrée Valeur
Description Détermine comment la stratégie de restriction logicielle (SRP) gère les tentatives de connexion aux processus existants. Si la valeur est false, les tentatives de connexion aux objets en cours d’exécution ne sont pas vérifiées pour les niveaux de confiance SRP appropriés. Si la valeur est true, l’objet en cours d’exécution doit avoir un niveau de confiance SRP égal ou supérieur à celui de l’objet client. Par exemple, un objet client avec un niveau de confiance SRP non restreint ne peut pas se connecter à un objet en cours d’exécution avec un niveau de confiance SRP interdit.
Access Lecture/écriture
Type Bool
Default Vrai
Système minimal Windows XP

TransactionTimeout

Entrée Valeur
Description Doit être défini sur une valeur suffisante en secondes si vous effectuez de nombreuses opérations au sein d’une transaction. Le délai d’attente par défaut est de 60 secondes et le délai d’expiration maximal est de 3600 secondes (1 heure). L’affectation de la valeur 0 à cette propriété désactive les délais d’expiration de la transaction. Cette propriété peut être remplacée par des composants individuels à l’aide de la propriété ComponentTransactionTimeout de la collection Components .
Access Lecture/écriture
Type Long (0-3600)
Default 60
Système minimal Windows 2000

Exemple

l’exemple de Visual Basic Microsoft suivant montre comment se connecter à un ordinateur distant et obtenir sa propriété SecurityTrackingEnabled à l’aide de la collection LocalComputer de l’ordinateur distant. pour utiliser cet exemple, ajoutez la bibliothèque de types d’administration COM+ en tant que référence à votre projet Visual Basic.

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


Pour utiliser la fonction, fournissez une valeur de chaîne pour le nom de l’ordinateur distant. le code Visual Basic suivant montre comment se connecter à l’ordinateur nommé « RemoteComputerName ».

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

Voir aussi

Regroupements d’administration COM+