Partager via

Collection LocalComputer

  • Article

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 Connect 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’une des collections suivantes :

Vous pouvez accéder à cette collection à partir des collections suivantes :

Propriétés

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

ApplicationProxyRSN

Entrée Valeur
Description Nom du serveur distant utilisé par les proxys d’application par défaut.
Access Lecture/écriture
Type Chaîne
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 Définissez sur True pour activer DCOM sur l’ordinateur.
Access Lecture/écriture
Type Bool
Default True
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 RPC (Remote Procedure Call).
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 lorsque COM appelle CoInitializeSecurity. Il est recommandé d’utiliser les constantes de l’énumération et non les valeurs numériques.

 

DefaultImpersonationLevel

Entrée Valeur
Description Niveau d’emprunt d’identité à autoriser si un n’est pas 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 de 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 Chaîne
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 True
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 intranet (False).
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

 

IsRouter

Entrée Valeur
Description Définissez sur True si l’ordinateur est un routeur pour le service d’équilibrage de charge des composants (CLB). Cette propriété peut être définie sur True uniquement si le service d’équilibrage de charge de composant est actuellement installé sur l’ordinateur ; sinon, il y a des erreurs avec COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

 

Si cette propriété a la valeur True, le serveur CLB est configuré et démarre au démarrage. Le serveur est ajouté à la collection ApplicationCluster s’il n’est pas déjà présent.

LoadBalancingCLSID

Entrée Valeur
Description CLSID de l’objet à équilibrer.
Access Lecture/écriture
Type Chaîne
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 True
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 Chaîne
Valeur par défaut « Poste de travail »
Système minimal Windows 2000

 

OperatingSystem

Entrée Valeur
Description 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 (5)COMAdminOSUnknown (2) 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 décrivant les ports destinés à l’utilisation d’Internet ou d’intranet, en fonction de la propriété InternetPortsListed ; par exemple, « 500-599 : 600-800 ».
Access Lecture/écriture
Type Chaîne
Valeur par défaut ""
Système minimal Windows 2000

 

ResourcePoolingEnabled

Entrée Valeur
Description Active l’utilisation de distributeurs de ressources.
Access Lecture/écriture
Type Bool
Default True
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 des appels au mécanisme RPC à partir d’IIS et est l’un des éléments principaux des services Internet COM, qui est activé en définissant CISEnabled sur 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 Applique dans les ordinateurs DCOM qui traitent entre les appels aux méthodes IUnknown::AddRef et IUnknown::Release sont sécurisés.
Access Lecture/écriture
Type Bool
Default False
Système minimal Windows 2000

 

SecurityTrackingEnabled

Entrée Valeur
Description Définissez sur True si le suivi de la sécurité est activé sur les objets.
Access Lecture/écriture
Type Bool
Default True
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 d’approbation SRP de l’objet client et le niveau de confiance plus élevé (plus strict) est utilisé pour exécuter l’objet serveur. S’il est défini sur False, l’objet serveur s’exécute avec le niveau d’approbation SRP de l’objet client, quel que soit le niveau d’approbation SRP avec lequel le serveur est configuré.
Access Lecture/écriture
Type Bool
Default True
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. S’il est défini sur True, l’objet en cours d’exécution doit avoir un niveau de confiance SRP égal ou supérieur (plus strict) à celui de l’objet client. Par exemple, un objet client avec un niveau d’approbation SRP non restreint ne peut pas se connecter à un objet en cours d’exécution avec un niveau de confiance SRP non autorisé.
Access Lecture/écriture
Type Bool
Default True
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’attente maximal est de 3 600 secondes (1 heure). La définition de cette propriété sur 0 désactive les délais d’expiration des transactions. 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 Microsoft Visual Basic 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 COM+ Administration 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+