Share via

Proveedores de extensibilidad de configuración declarados

La inscripción de configuración declarada, que admite la pila de cliente de configuración declarada, ofrece extensibilidad a través de proveedores WMI nativos. Esta característica crea instancias e interfaces con un proveedor de Instrumental de administración de Windows (WMI) que ha implementado una interfaz de infraestructura de administración (MI). La interfaz debe implementar los métodos GetTargetResource, TestTargetResource y SetTargetResource, y puede implementar cualquier número de propiedades de cadena.

Nota

Actualmente, los proveedores de extensibilidad solo admiten las propiedades de cadena.

[static, Description ("Get resource state based on input configuration file." )]
uint32 GetTargetResource(
    [in, EmbeddedInstance ("MSFT_FileDirectoryConfiguration"), Description ("Configuration document that is to be applied.")]
    string InputResource,
    [in, Description ("Flags passed to the provider. Reserved for future use." )]
    uint32 Flags,
    [out, EmbeddedInstance ("MSFT_FileDirectoryConfiguration"), Description ("The current state of the specified configuration resources." )]
    string OutputResource
);

[static, Description ("Test resource state based on input configuration file." )]
uint32 TestTargetResource(
    [in, EmbeddedInstance("MSFT_FileDirectoryConfiguration"), Description ("Configuration document to be applied." )]
    string InputResource,
    [in, Description ("Flags passed to the provider. reserved for future use." )]
    uint32 Flags,
    [out, Description ("True if identical. False otherwise." )]
    boolean Result,
    [out, Description ("Context information the provider can use to optimize the set. This is optional." )]
    uint64 ProviderContext
);

[static, Description ("Set resource state based on input configuration file." )]
uint32 SetTargetResource(
    [in, EmbeddedInstance ("MSFT_FileDirectoryConfiguration"),
    Description ("Configuration document to be applied." )]
    string InputResource,
    [in, Description ("Context information the provider can use to optimize the set from SetTargetResource. This is optional." )]
    uint64 ProviderContext,
    [in, Description ("Flags passed to the provider. reserved for future use." )]
    uint32 Flags
);

Creación de recursos de configuración de estado deseados

Para crear un proveedor WMI nativo, siga los pasos descritos en Implementación de un proveedor de MI. Estos pasos incluyen cómo generar el código fuente de una interfaz mi mediante la Convert-MofToProvider.exe herramienta para generar el archivo DLL y prepararlo para la selección de ubicación.

  1. Cree un archivo MOF que defina el esquema para el recurso de configuración de estado deseado, incluidos los parámetros y métodos. Este archivo incluye los parámetros necesarios para el recurso.
  2. Copie el archivo MOF de esquema junto con los archivos necesarios en el directorio de herramientas del proveedor, por ejemplo: ProviderGenerationTool.
  3. Edite los archivos necesarios e incluya los nombres de archivo y de clase correctos.
  4. Invoque la herramienta generadora del proveedor para generar los archivos de proyecto del proveedor.
  5. Copie los archivos generados en la carpeta del proyecto del proveedor.
  6. Inicie el proceso de desarrollo.

Por ejemplo:

En este ejemplo se proporcionan más detalles sobre cada paso para demostrar cómo implementar un recurso nativo de ejemplo denominado MSFT_FileDirectoryConfiguration.

Paso 1: Creación del archivo MOF de esquema de recursos

Cree un archivo MOF de esquema de ejemplo que se usa para generar el código fuente inicial para el MSFT_FileDirectoryConfiguration recurso nativo. Colócelo en el directorio del proyecto denominado MSFT_FileDirectoryConfiguration.

#pragma include ("cim_schema_2.26.0.mof")
#pragma include ("OMI_BaseResource.mof")
#pragma include ("MSFT_Credential.mof")

[ClassVersion("1.0.0"), Description("The configuration provider for files and directories.")]
class MSFT_FileDirectoryConfiguration : OMI_BaseResource
{
    [Key, Description("File name and path on target node to copy or create.")]
    string DestinationPath;

    [Write, Description("The name and path of the file to copy from.")]
    string SourcePath;

    [Write, Description("Contains a string that represents the contents of the file. To create an empty file, the string must be empty. The contents will be written and compared using UTF-8 character encoding.")]
    string Contents;

    [static, Description ("Get resource states based on input configuration file." )]
    uint32 GetTargetResource(
        [in, EmbeddedInstance ("MSFT_FileDirectoryConfiguration"), Description ("Configuration document that is to be applied." )]
        string InputResource,

        [in,Description ("Flags passed to the providers. Reserved for future use." )]
        uint32 Flags,

        [out, EmbeddedInstance ("MSFT_FileDirectoryConfiguration"), Description ("The current state of the specified configuration resources." )]
        string OutputResource
    );

    [static, Description ("Test resource states based on input configuration file." )]
    uint32 TestTargetResource(
        [in, EmbeddedInstance("MSFT_FileDirectoryConfiguration"), Description ("Configuration document that to be applied." )]
        string InputResource,

        [in, Description ("Flags passed to the providers. reserved for future use." )]
        uint32 Flags,

        [out, Description ("True if identical. False otherwise." )]
        boolean Result,

        [out, Description ("Context information that the provider can use to optimize the set, This is optional." )]
        uint64 ProviderContext
    );

    [static, Description ("Set resource states based on input configuration file." )]
    uint32 SetTargetResource(
        [in, EmbeddedInstance ("MSFT_FileDirectoryConfiguration"), Description ("Configuration document that to be applied." )]
        string InputResource,

        [in, Description ("Context information that the provider can use to optimize the set from TestTargetResource, This is optional." )]
        uint64 ProviderContext,

        [in, Description ("Flags passed to the providers. reserved for future use." )]
        uint32 Flags
    );
};

Nota

  • El nombre de clase y el nombre de archivo DLL deben ser los mismos, tal como se define en el Provider.DEF archivo.

  • El calificador [Key] de tipo de una propiedad indica que identifica de forma única la instancia de recurso. Se requiere al menos una [Key] propiedad.

  • El [Required] calificador indica que la propiedad es necesaria. Es decir, se debe especificar un valor en cualquier script de configuración que use este recurso.

  • El [write] calificador indica que la propiedad es opcional cuando se usa el recurso personalizado en un script de configuración. El [read] calificador indica que una configuración no puede establecer una propiedad y es solo para fines de informes.

  • El [Values] calificador restringe los valores que se pueden asignar a la propiedad . Defina la lista de valores permitidos en [ValueMap]. Para obtener más información, vea ValueMap y calificadores de valor.

  • Cualquier nuevo archivo MOF debe incluir las siguientes líneas en la parte superior del archivo:

    #pragma include ("cim_schema_2.26.0.mof")
#pragma include ("OMI_BaseResource.mof")
#pragma include ("MSFT_Credential.mof")

  • Los nombres de método y sus parámetros deben ser iguales para cada recurso. Cambie MSFT_FileDirectoryConfiguration del valor EmbeddedInstance al nombre de clase del proveedor deseado. Solo debe haber un proveedor por archivo MOF.

Paso 2: Copiar los archivos MOF de esquema

Copie estos archivos y carpetas necesarios en el directorio del proyecto que creó en el paso 1:

  • CIM-2.26.0
  • codegen.cmd
  • Convert-MofToProvider.exe
  • MSFT_Credential.mof
  • MSFT_DSCResource.mof
  • OMI_BaseResource.mof
  • OMI_Errors.mof
  • Provider.DEF
  • wmicodegen.dll

Para obtener más información sobre cómo obtener los archivos necesarios, consulte Cómo implementar un proveedor de MI.

Paso 3: Editar los archivos necesarios

Modifique los siguientes archivos en el directorio del proyecto:

  • MSFT_FileDirectoryConfiguration.mof: ha creado este archivo en el paso 1.

  • Provider.DEF: este archivo contiene el nombre del archivo DLL, por ejemplo, MSFT_FileDirectoryConfiguration.dll.

  • codegen.cmd: este archivo contiene el comando para invocar convert-moftoprovider.exe.

    "convert-moftoprovider.exe" ^
   -MofFile MSFT_FileDirectoryConfiguration.mof ^
            MSFT_DSCResource.mof ^
            OMI_Errors.mof ^
   -ClassList MSFT_FileDirectoryConfiguration ^
   -IncludePath CIM-2.26.0 ^
   -ExtraClass OMI_Error ^
               MSFT_DSCResource ^
   -OutPath temp

Paso 4: Ejecución de la herramienta generador de proveedores

Ejecute codegen.cmd, que ejecuta el convert-moftoprovider.exe comando . Como alternativa, puede ejecutar el comando directamente.

Paso 5: Copia de los archivos de origen generados

El comando del paso 3 especifica el -OutPath parámetro , que en este ejemplo es una carpeta denominada temp. Al ejecutar la herramienta en el paso 4, se crean nuevos archivos en esta carpeta. Copie los archivos generados de esta temp carpeta en el directorio del proyecto. Ha creado el directorio del proyecto en el paso 1, que en este ejemplo es MSFT_FileDirectoryConfiguration.

Nota

Cada vez que actualice el archivo MOF de esquema, ejecute el codegen.cmd script para volver a generar los archivos de origen. Al volver a ejecutar la herramienta generador, se sobrescriben los archivos de origen existentes. Para evitar este comportamiento, en este ejemplo se usa una carpeta temporal. Minimice las actualizaciones del archivo MOF de esquema, ya que la implementación principal debe combinarse con los archivos de origen generados automáticamente más recientes.

Acerca del MSFT_FileDirectoryConfiguration recurso

Después de ejecutar la herramienta generadora de proveedores, crea varios archivos de origen y encabezado:

  • MSFT_FileDirectoryConfiguration.c
  • MSFT_FileDirectoryConfiguration.h
  • module.c
  • schema.c
  • WMIAdapter.c

En esta lista, solo tiene que modificar MSFT_FileDirectoryConfiguration.c y MSFT_FileDirectoryConfiguration.h. También puede cambiar la extensión de los archivos de origen de .c a .cpp, que es el caso de este recurso. La lógica de negocios de este recurso se implementa en MSFT_FileDirectoryConfigurationImp.cpp y MSFT_FileDirectoryConfigurationImp.h. Estos nuevos archivos se agregan al directorio del MSFT_FileDirectoryConfiguration proyecto después de ejecutar la herramienta generador de proveedores.

Para un recurso de configuración de estado deseado nativo, tiene que implementar tres funciones generadas automáticamente en MSFT_FileDirectoryConfiguration.cpp:

  • MSFT_FileDirectoryConfiguration_Invoke_GetTargetResource
  • MSFT_FileDirectoryConfiguration_Invoke_TestTargetResource
  • MSFT_FileDirectoryConfiguration_Invoke_SetTargetResource

A partir de estas tres funciones, solo MSFT_FileDirectoryConfiguration_Invoke_GetTargetResource es necesario para un escenario Get. MSFT_FileDirectoryConfiguration_Invoke_TestTargetResource y MSFT_FileDirectoryConfiguration_Invoke_SetTargetResource se usan cuando se necesita la corrección.

Hay otras funciones generadas automáticamente en MSFT_FileDirectoryConfiguration.cpp que no necesitan implementación para un recurso de configuración de estado deseado nativo. No es necesario modificar las siguientes funciones:

  • MSFT_FileDirectoryConfiguration_Load
  • MSFT_FileDirectoryConfiguration_Unload
  • MSFT_FileDirectoryConfiguration_EnumerateInstances
  • MSFT_FileDirectoryConfiguration_GetInstance
  • MSFT_FileDirectoryConfiguration_CreateInstance
  • MSFT_FileDirectoryConfiguration_ModifyInstance
  • MSFT_FileDirectoryConfiguration_DeleteInstance

Acerca de MSFT_FileDirectoryConfiguration_Invoke_GetTargetResource

La MSFT_FileDirectoryConfiguration_Invoke_GetTargetResource función realiza los pasos siguientes para completar su tarea:

  1. Valide el recurso de entrada.

  2. Asegúrese de que las claves y los parámetros necesarios están presentes.

  3. Cree una instancia de recurso que se use como salida del método Get. Esta instancia es de tipo MSFT_FileDirectoryConfiguration, que se deriva de MI_Instance.

  4. Cree la instancia de recurso de salida a partir de la instancia de recurso modificada y devuévalo al cliente de MI llamando a estas funciones:

    • MSFT_FileDirectoryConfiguration_GetTargetResource_Construct
    • MSFT_FileDirectoryConfiguration_GetTargetResource_SetPtr_OutputResource
    • MSFT_FileDirectoryConfiguration_GetTargetResource_Set_MIReturn
    • MSFT_FileDirectoryConfiguration_GetTargetResource_Post
    • MSFT_FileDirectoryConfiguration_GetTargetResource_Destruct

  5. Limpie los recursos, por ejemplo, la memoria asignada libre.

Referencias de implementación de MI