Cómo leer un objeto Configuration Manager mediante código administrado

Para leer una instancia de objeto Configuration Manager mediante el proveedor de SMS administrado, use WqlConnectionManager.GetInstance. El método GetInstance toma una cadena que identifica una instancia de objeto específica y devuelve un objeto IResultObject que se usa para acceder al objeto.

La siguiente función de ejemplo muestra el nombre y la descripción de un identificador de paquete proporcionado.

Para leer un objeto Configuration Manager

1. Configure una conexión con el proveedor de SMS. Para obtener más información, vea Cómo conectarse a un proveedor de SMS en Configuration Manager mediante código administrado.

2. Llame al método GetInstance de la clase WqlConnectionManager para obtener el objeto IResultObject del objeto que desee.

3. Muestra las propiedades de IResultObject.

Ejemplo

En el ejemplo de código siguiente se muestra cómo leer un objeto Configuration Manager.

Para obtener información sobre cómo llamar al código de ejemplo, vea Llamar a fragmentos de código de Configuration Manager.

public void DisplayPackageName(WqlConnectionManager connection, string packageID)  
{  
    try   
    {  
        // Get the package.  
        IResultObject package = connection.GetInstance(@"SMS_Package.PackageID='" + packageID + "'");  
        Console.WriteLine("Package Name: " + package["Name"].StringValue);  
        Console.WriteLine("Package Description: " + package["Description"].StringValue);  
    }  
    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed to get package. Error: " + ex.Message);  
        throw;  
    }  
}  

Este método de ejemplo tiene los parámetros siguientes:

Parámetro	Tipo	Descripción
Connection	-Administrado: WqlConnectionManager	- Una conexión válida al proveedor de SMS.
PackageID	-Administrado: String	Un identificador de paquete válido. Obtenido de la propiedad PackageID de la clase SMS_Package .

Compilar el código

Espacios de nombres

System

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Ensamblado

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programación sólida

Las excepciones Configuration Manager que se pueden generar son SmsConnectionException y SmsQueryException. Estos se pueden detectar junto con SmsException.

Consulta también

Introducción a los objetosConfiguration Manager Propiedades diferidas
Cómo llamar a un método de clase de objeto Configuration Manager mediante código administrado
Conexión a un proveedor de Configuration Manager mediante código administrado
Creación de un objeto Configuration Manager mediante código administrado
Cómo modificar un objeto Configuration Manager mediante código administrado
Cómo realizar una consulta de Configuration Manager asincrónica mediante código administrado
Cómo realizar una consulta de Configuration Manager sincrónica mediante código administrado
Cómo leer propiedades diferidas mediante código administrado