Configuración del administrador de configuración localConfiguring the Local Configuration Manager

Se aplica a: Windows PowerShell 5.0Applies To: Windows PowerShell 5.0

El administrador de configuración local (LCM) es el motor de Desired State Configuration (DSC).The Local Configuration Manager (LCM) is the engine of Desired State Configuration (DSC). El LCM se ejecuta en cada nodo de destino y es el responsable de analizar y establecer las configuraciones que se envían al nodo.The LCM runs on every target node, and is responsible for parsing and enacting configurations that are sent to the node. También es responsable de diversos otros aspectos de DSC, entre los que se incluyen los siguientes.It is also responsible for a number of other aspects of DSC, including the following.

  • Determinar el modo de actualización (inserción o extracción).Determining refresh mode (push or pull).
  • Especificar la frecuencia con que un nodo extrae y aplica configuraciones.Specifying how often a node pulls and enacts configurations.
  • Asociar el nodo con el servicio de extracción.Associating the node with pull service.
  • Especificar configuraciones parciales.Specifying partial configurations.

Se utiliza un tipo especial de configuración para configurar el LCM a fin de que especifique cada uno de estos comportamientos.You use a special type of configuration to configure the LCM to specify each of these behaviors. En las siguientes secciones se describe cómo configurar el LCM.The following sections describe how to configure the LCM.

Con Windows PowerShell 5.0 se incluyeron nuevas configuraciones para administrar el Administrador de configuración local.Windows PowerShell 5.0 introduced new settings for managing Local Configuration Manager. Para obtener información sobre cómo configurar el LCM en Windows PowerShell 4.0, consulte Administrador de configuración local (LCM) de la configuración de estado deseado de Windows PowerShell 4.0.For information about configuring the LCM in Windows PowerShell 4.0, see Configuring the Local Configuration Manager in Previous Versions of Windows PowerShell.

Escritura y aplicación de una configuración de LCMWriting and enacting an LCM configuration

Para configurar el LCM, debe crear y ejecutar un tipo especial de configuración que aplique los valores de LCM.To configure the LCM, you create and run a special type of configuration that applies LCM settings. Para especificar una configuración de LCM, utilice el atributo DscLocalConfigurationManager.To specify an LCM configuration, you use the DscLocalConfigurationManager attribute. A continuación se muestra una configuración sencilla que establece el LCM en el modo de inserción.The following shows a simple configuration that sets the LCM to push mode.

[DSCLocalConfigurationManager()]
configuration LCMConfig
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Push'
        }
    }
}

El proceso de aplicar los valores al LCM es similar a la aplicación de una configuración DSC.The process of applying settings to LCM is similar to applying a DSC configuration. Creará una configuración de LCM, la compilará en un archivo MOF y la aplicará en el nodo.You will create an LCM configuration, compile it to a MOF file, and apply it to the node. A diferencia de las configuraciones DSC, no aplique una configuración LCM con una llamada al cmdlet Start-DscConfiguration.Unlike DSC configurations, you do not enact an LCM configuration by calling the Start-DscConfiguration cmdlet. En su lugar, llame al cmdlet Set-DscLocalConfigurationManager y proporcione la ruta de acceso al MOF de configuración de LCM como un parámetro.Instead, you call Set-DscLocalConfigurationManager, supplying the path to the LCM configuration MOF as a parameter. Después de establecer la configuración de LCM, podrá ver las propiedades del LCM con una llamada al cmdlet Get-DscLocalConfigurationManager.After you enact the LCM configuration, you can see the properties of the LCM by calling the Get-DscLocalConfigurationManager cmdlet.

Una configuración de LCM puede contener bloques solo para un conjunto limitado de recursos.An LCM configuration can contain blocks only for a limited set of resources. En el ejemplo anterior, el único recurso al que se llama es Settings.In the previous example, the only resource called is Settings. El resto de recursos disponibles son:The other available resources are:

  • ConfigurationRepositoryWeb : especifica un servicio de extracción HTTP para configuraciones.ConfigurationRepositoryWeb : specifies an HTTP pull service for configurations.
  • ConfigurationRepositoryShare : especifica un recurso compartido SMB para configuraciones.ConfigurationRepositoryShare : specifies an SMB share for configurations.
  • ResourceRepositoryWeb : especifica un servicio de extracción HTTP para módulos.ResourceRepositoryWeb : specifies an HTTP pull service for modules.
  • ResourceRepositoryShare : especifica un recurso compartido SMB para módulos.ResourceRepositoryShare : specifies an SMB share for modules.
  • ReportServerWeb : especifica un servicio de extracción HTTP al que se envían informes.ReportServerWeb : specifies an HTTP pull service to which reports are sent.
  • PartialConfiguration : proporciona datos para habilitar las configuraciones parciales.PartialConfiguration : provides data to enable partial configurations.

Configuración básicaBasic settings

Aparte de especificar puntos de conexión o rutas de acceso del servicio de extracción y configuraciones parciales, todas las propiedades del LCM se configuran en un bloque Settings.Other than specifying pull service endpoints/paths and partial configurations, all of the properties of the LCM are configured in a Settings block. Las propiedades siguientes están disponibles en un bloque Settings.The following properties are available in a Settings block.

PropiedadProperty TipoType DescripciónDescription
ActionAfterRebootActionAfterReboot stringstring Especifica lo que ocurre tras un reinicio durante la aplicación de una configuración.Specifies what happens after a reboot during the application of a configuration. Los valores posibles son "ContinueConfiguration" y "StopConfiguration" .The possible values are "ContinueConfiguration" and "StopConfiguration".
  • ContinueConfiguration : continúe aplicando la configuración actual después de reiniciar el equipo.ContinueConfiguration : Continue applying the current configuration after machine reboot. Este es el valor predeterminadoThis is the default value
  • StopConfiguration : detenga la configuración actual después de reiniciar el equipo.StopConfiguration : Stop the current configuration after machine reboot.
AllowModuleOverwriteAllowModuleOverwrite boolbool $TRUE si se permite que las nuevas configuraciones descargadas desde el servicio de extracción sobrescriban las antiguas en el nodo de destino.$TRUE if new configurations downloaded from the pull service are allowed to overwrite the old ones on the target node. En caso contrario, $FALSE.Otherwise, $FALSE.
CertificateIDCertificateID stringstring La huella digital de un certificado usado para proteger las credenciales que se han pasado en una configuración.The thumbprint of a certificate used to secure credentials passed in a configuration. Para más información, consulte Want to secure credentials in Windows PowerShell Desired State Configuration? (¿Quiere proteger las credenciales de configuración de estado deseado de Windows PowerShell?).For more information see Want to secure credentials in Windows PowerShell Desired State Configuration?.
Nota: Se administra automáticamente si se usa el servicio de extracción DSC de Azure Automation.Note: this is managed automatically if using Azure Automation DSC pull service.
ConfigurationDownloadManagersConfigurationDownloadManagers CimInstance[]CimInstance[] Obsoleto.Obsolete. Use los bloques ConfigurationRepositoryWeb y ConfigurationRepositoryShare para definir puntos de conexión del servicio de extracción de configuración.Use ConfigurationRepositoryWeb and ConfigurationRepositoryShare blocks to define configuration pull service endpoints.
ConfigurationIDConfigurationID stringstring Para la compatibilidad con versiones anteriores con versiones anteriores del servicio de extracción.For backwards compatibility with older pull service versions. Un GUID que identifica el archivo de configuración que se obtendrá de un servicio de extracción.A GUID that identifies the configuration file to get from a pull service. El nodo extraerá las configuraciones del servicio de extracción si el nombre del MOF de configuración es ConfigurationID.mof.The node will pull configurations on the pull service if the name of the configuration MOF is named ConfigurationID.mof.
Nota: Si establece esta propiedad, el registro del nodo con un servicio de extracción mediante RegistrationKey no funcionará.Note: If you set this property, registering the node with a pull service by using RegistrationKey does not work. Para más información, consulte Configuración de un cliente de incorporación de cambios con nombres de configuración.For more information, see Setting up a pull client with configuration names.
ConfigurationModeConfigurationMode stringstring Especifica la forma en que el LCM aplica realmente la configuración a los nodos de destino.Specifies how the LCM actually applies the configuration to the target nodes. Los valores posibles son "ApplyOnly" , "ApplyAndMonitor" y "ApplyAndAutoCorrect" .Possible values are "ApplyOnly" , "ApplyAndMonitor" , and "ApplyAndAutoCorrect".
  • ApplyOnly : DSC aplica la configuración y no hace nada más, a menos que se inserte una nueva configuración en el nodo de destino o se extraiga una nueva configuración de un servicio.ApplyOnly : DSC applies the configuration and does nothing further unless a new configuration is pushed to the target node or when a new configuration is pulled from a service. Después de la aplicación inicial de una nueva configuración, DSC no comprueba si se ha producido una desviación desde un estado configurado previamente.After initial application of a new configuration, DSC does not check for drift from a previously configured state. Tenga en cuenta que DSC intentará aplicar la configuración hasta que lo consiga antes de que ApplyOnly surta efecto.Note that DSC will attempt to apply the configuration until it is successful before ApplyOnly takes effect.
  • ApplyAndMonitor : Este es el valor predeterminado.ApplyAndMonitor : This is the default value. El LCM aplica las nuevas configuraciones.The LCM applies any new configurations. Después de la aplicación inicial de una nueva configuración, si el nodo de destino se desvía del estado deseado, DSC notifica la discrepancia en los registros.After initial application of a new configuration, if the target node drifts from the desired state, DSC reports the discrepancy in logs. Tenga en cuenta que DSC intentará aplicar la configuración hasta que lo consiga antes de que ApplyAndMonitor surta efecto.Note that DSC will attempt to apply the configuration until it is successful before ApplyAndMonitor takes effect.
  • ApplyAndAutoCorrect : DSC aplica las nuevas configuraciones.ApplyAndAutoCorrect : DSC applies any new configurations. Después de la aplicación inicial de una nueva configuración, si el nodo de destino se desplaza del estado deseado, DSC notifica la discrepancia en los registros y después vuelve a aplicar la configuración actual.After initial application of a new configuration, if the target node drifts from the desired state, DSC reports the discrepancy in logs, and then re-applies the current configuration.
ConfigurationModeFrequencyMinsConfigurationModeFrequencyMins UInt32UInt32 La frecuencia, en minutos, con que se comprueba y aplica la configuración actual.How often, in minutes, the current configuration is checked and applied. Esta propiedad se omite si la propiedad ConfigurationMode se establece en ApplyOnly.This property is ignored if the ConfigurationMode property is set to ApplyOnly. El valor predeterminado es 15.The default value is 15.
DebugModeDebugMode stringstring Los valores posibles son None , ForceModuleImport y All.Possible values are None , ForceModuleImport , and All.
  • Establézcala en None para utilizar los recursos almacenados en caché.Set to None to use cached resources. Este es el valor predeterminado y debe utilizarse en escenarios de producción.This is the default and should be used in production scenarios.
  • Si se establece en ForceModuleImport , provocará que el LCM vuelva a cargar los módulos de recursos de DSC, incluso aunque se hayan cargado y almacenado en caché previamente.Setting to ForceModuleImport , causes the LCM to reload any DSC resource modules, even if they have been previously loaded and cached. Esto afecta al rendimiento de las operaciones de DSC, ya que cada módulo se recarga cuando se usa.This impacts the performance of DSC operations as each module is reloaded on use. Normalmente, este valor se usaría durante la depuración de un recurso.Typically you would use this value while debugging a resource
  • En esta versión, All es lo mismo que ForceModuleImport.In this release, All is same as ForceModuleImport
RebootNodeIfNeededRebootNodeIfNeeded boolbool Establezca esta opción en $true para permitir que los recursos reinicien el nodo usando la marca $global:DSCMachineStatus.Set this to $true to allow resources to reboot the Node using the $global:DSCMachineStatus flag. De lo contrario, tendrá que reiniciar manualmente el nodo de configuración que lo requiera.Otherwise, you will have to manually reboot the node for any configuration that requires it. El valor predeterminado es $false.The default value is $false. Para usar esta configuración cuando una instancia distinta de DSC (como Windows Installer) implementa una condición de reinicio, combine la configuración con el recurso PendingReboot del módulo ComputerManagementDsc.To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the PendingReboot resource in the ComputerManagementDsc module.
RefreshModeRefreshMode stringstring Especifica cómo obtiene el LCM las configuraciones.Specifies how the LCM gets configurations. Los valores posibles son "Disabled" , "Push" y "Pull" .The possible values are "Disabled" , "Push" , and "Pull".
  • Disabled : las configuraciones DSC se deshabilitan para este nodo.Disabled : DSC configurations are disabled for this node.
  • Push : las configuraciones se inician con una llamada al cmdlet Start-DscConfiguration.Push : Configurations are initiated by calling the Start-DscConfiguration cmdlet. La configuración se aplica inmediatamente al nodo.The configuration is applied immediately to the node. Este es el valor predeterminado.This is the default value.
  • Pull: el nodo se configura para comprobar con regularidad si existen configuraciones en una ruta de acceso de SMB o un servicio de extracción.Pull: The node is configured to regularly check for configurations from a pull service or SMB path. Si esta propiedad se establece en Pull , se debe especificar una ruta de acceso HTTP (servicio) o SMB (recurso compartido) en un bloque ConfigurationRepositoryWeb o ConfigurationRepositoryShare.If this property is set to Pull , you must specify an HTTP (service) or SMB (share) path in a ConfigurationRepositoryWeb or ConfigurationRepositoryShare block.
RefreshFrequencyMinsRefreshFrequencyMins Uint32Uint32 El intervalo de tiempo, en minutos, que emplea el LCM para comprobar un servicio de extracción en busca de configuraciones actualizadas.The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. Este valor se omite si el LCM no está configurado en el modo de extracción.This value is ignored if the LCM is not configured in pull mode. El valor predeterminado es 30.The default value is 30.
ReportManagersReportManagers CimInstance[]CimInstance[] Obsoleto.Obsolete. Use los bloques ReportServerWeb para definir un punto de conexión para enviar datos de informes a un servicio de extracción.Use ReportServerWeb blocks to define an endpoint to send reporting data to a pull service.
ResourceModuleManagersResourceModuleManagers CimInstance[]CimInstance[] Obsoleto.Obsolete. Use los bloques ResourceRepositoryWeb y ResourceRepositoryShare para definir puntos de conexión HTTP o rutas de acceso SMB del servicio de extracción, respectivamente.Use ResourceRepositoryWeb and ResourceRepositoryShare blocks to define pull service HTTP endpoints or SMB paths, respectively.
PartialConfigurationsPartialConfigurations CimInstanceCimInstance No implementado.Not implemented. No debe usarse.Do not use.
StatusRetentionTimeInDaysStatusRetentionTimeInDays UInt32UInt32 El número de días que el LCM mantiene el estado de la configuración actual.The number of days the LCM keeps the status of the current configuration.

Nota

El LCM inicia el ciclo ConfigurationModeFrequencyMins según lo siguiente:The LCM starts the ConfigurationModeFrequencyMins cycle based on:

  • Nueva metaconfiguración aplicada con un cambio en ConfigurationModeFrequencyMins mediante Set-DscLocalConfigurationManagerA new metaconfig with a change to ConfigurationModeFrequencyMins is applied using Set-DscLocalConfigurationManager
  • Un reinicio del equipoA machine restart

En cualquier condición en la cual el proceso de temporizador experimente un bloqueo, se detectará dentro del plazo de 30 segundos y se reiniciará el ciclo.For any condition where the timer process experiences a crash, that will be detected within 30 seconds and the cycle will be restarted. Una operación simultánea puede retrasar el ciclo de inicio; si la duración de esta operación supera la frecuencia del ciclo configurado, el siguiente temporizador no se iniciará.A concurrent operation could delay the cycle from being started, if the duration of this operation exceeds the configured cycle frequency, the next timer will not start. Por ejemplo, la metaconfiguración se configura con una frecuencia de extracción de 15 minutos y se produce una extracción en T1.Example, the metaconfig is configured at a 15 minute pull frequency and a pull occurs at T1. El nodo no finaliza el trabajo en 16 minutos.The Node does not finish work for 16 minutes. Se omite el primer ciclo de 15 minutos y la extracción siguiente se realizará en T1+15+15.The first 15 minute cycle is ignored, and next pull will happen at T1+15+15.

Servicio de extracciónPull service

La configuración de LCM admite la definición de los siguientes puntos de conexión del servicio de extracción:LCM configuration supports defining the following types of pull service endpoints:

  • Servidor de configuración : un repositorio para las configuraciones de DSC.Configuration server : A repository for DSC configurations. Defina servidores de configuración mediante el uso de bloques ConfigurationRepositoryWeb (para servidores basados en web) y ConfigurationRepositoryShare (para servidores basados en SMB).Define configuration servers by using ConfigurationRepositoryWeb (for web-based servers) and ConfigurationRepositoryShare (for SMB-based servers) blocks.
  • Servidor de recursos : un repositorio para recursos de DSC, empaquetado como módulos de PowerShell.Resource server : A repository for DSC resources, packaged as PowerShell modules. Defina servidores de recursos mediante el uso de bloques ResourceRepositoryWeb (para servidores basados en web) y ResourceRepositoryShare (para servidores basados en SMB).Define resource servers by using ResourceRepositoryWeb (for web-based servers) and ResourceRepositoryShare (for SMB-based servers) blocks.
  • Servidor de informes : un servicio al que DSC envía datos de informes.Report server : A service that DSC sends report data to. Defina servidores de informes mediante bloques ReportServerWeb.Define report servers by using ReportServerWeb blocks. Un servidor de informes debe ser un servicio web.A report server must be a web service.

Para ver más detalles sobre el servicio de extracción, consulte Servicio de extracción de Desired State Configuration.For more details on pull service see, Desired State Configuration Pull Service.

Bloques del servidor de configuraciónConfiguration server blocks

Para definir un servidor de configuración basado en web, cree un bloque ConfigurationRepositoryWeb.To define a web-based configuration server, you create a ConfigurationRepositoryWeb block. Un bloque ConfigurationRepositoryWeb define las siguientes propiedades.A ConfigurationRepositoryWeb defines the following properties.

PropiedadProperty TipoType DescripciónDescription
AllowUnsecureConnectionAllowUnsecureConnection boolbool Establézcala en $TRUE para permitir conexiones desde el nodo al servidor sin autenticación.Set to $TRUE to allow connections from the node to the server without authentication. Establézcala en $FALSE para que se requiera autenticación.Set to $FALSE to require authentication.
CertificateIDCertificateID stringstring La huella digital de un certificado usado para autenticar el servidor.The thumbprint of a certificate used to authenticate to the server.
ConfigurationNamesConfigurationNames String[]String[] Una matriz de nombres de configuraciones que el nodo de destino extraerá.An array of names of configurations to be pulled by the target node. Solo se usan si el nodo se registra con el servicio de extracción mediante un elemento RegistrationKey.These are used only if the node is registered with the pull service by using a RegistrationKey. Para más información, consulte Configuración de un cliente de incorporación de cambios con nombres de configuración.For more information, see Setting up a pull client with configuration names.
RegistrationKeyRegistrationKey stringstring Un GUID que registra el nodo con el servicio de extracción.A GUID that registers the node with the pull service. Para más información, consulte Configuración de un cliente de incorporación de cambios con nombres de configuración.For more information, see Setting up a pull client with configuration names.
ServerURLServerURL stringstring La dirección URL del servicio de configuración.The URL of the configuration service.
ProxyURL*ProxyURL* stringstring URL del proxy HTTP que se debe usar al conectar con el servicio de configuración.The URL of the http proxy to use when communicating with the configuration service.
ProxyCredential*ProxyCredential* PSCredentialpscredential Credencial que se debe usar para el proxy HTTP.Credential to use for the http proxy.

Nota

Se admite en Windows 1809 y versiones posteriores.Supported in Windows versions 1809 and later.

Hay disponible un script de ejemplo para simplificar la configuración del valor ConfigurationRepositoryWeb para los nodos locales, consulte el artículo sobre la configuración de metaconfiguraciones DSCAn example script to simplify configuring the ConfigurationRepositoryWeb value for on-premises nodes is available - see Generating DSC metaconfigurations

Para definir un servidor de configuración basado en SMB, cree un bloque ConfigurationRepositoryShare.To define an SMB-based configuration server, you create a ConfigurationRepositoryShare block. Un bloque ConfigurationRepositoryShare define las siguientes propiedades.A ConfigurationRepositoryShare defines the following properties.

PropiedadProperty TipoType DescripciónDescription
Credential:Credential MSFT_CredentialMSFT_Credential La credencial usada para autenticarse en el recurso compartido SMB.The credential used to authenticate to the SMB share.
SourcePathSourcePath stringstring La ruta de acceso del recurso compartido SMB.The path of the SMB share.

Bloques del servidor de recursosResource server blocks

Para definir un servidor de recursos basado en web, cree un bloque ResourceRepositoryWeb.To define a web-based resource server, you create a ResourceRepositoryWeb block. Un bloque ResourceRepositoryWeb define las siguientes propiedades.A ResourceRepositoryWeb defines the following properties.

PropiedadProperty TipoType DescripciónDescription
AllowUnsecureConnectionAllowUnsecureConnection boolbool Establézcala en $TRUE para permitir conexiones desde el nodo al servidor sin autenticación.Set to $TRUE to allow connections from the node to the server without authentication. Establézcala en $FALSE para que se requiera autenticación.Set to $FALSE to require authentication.
CertificateIDCertificateID stringstring La huella digital de un certificado usado para autenticar el servidor.The thumbprint of a certificate used to authenticate to the server.
RegistrationKeyRegistrationKey stringstring Un GUID que identifica el nodo para el servicio de extracción.A GUID that identifies the node to the pull service.
ServerURLServerURL stringstring La dirección URL del servidor de configuración.The URL of the configuration server.
ProxyURL*ProxyURL* stringstring URL del proxy HTTP que se debe usar al conectar con el servicio de configuración.The URL of the http proxy to use when communicating with the configuration service.
ProxyCredential*ProxyCredential* PSCredentialpscredential Credencial que se debe usar para el proxy HTTP.Credential to use for the http proxy.

Nota

Se admite en Windows 1809 y versiones posteriores.Supported in Windows versions 1809 and later.

Hay disponible un script de ejemplo para simplificar la configuración del valor ResourceRepositoryWeb para los nodos locales, consulte el artículo sobre la configuración de metaconfiguraciones DSCAn example script to simplify configuring the ResourceRepositoryWeb value for on-premises nodes is available - see Generating DSC metaconfigurations

Para definir un servidor de recursos basado en SMB, cree un bloque ResourceRepositoryShare.To define an SMB-based resource server, you create a ResourceRepositoryShare block. ResourceRepositoryShare define las siguientes propiedades.ResourceRepositoryShare defines the following properties.

PropiedadProperty TipoType DescripciónDescription
Credential:Credential MSFT_CredentialMSFT_Credential La credencial usada para autenticarse en el recurso compartido SMB.The credential used to authenticate to the SMB share. Para obtener un ejemplo de transferencia de credenciales, consulte Configuración de un servidor de incorporación de cambios SMB de DSCFor an example of passing credentials, see Setting up a DSC SMB pull server
SourcePathSourcePath stringstring La ruta de acceso del recurso compartido SMB.The path of the SMB share.

Bloques del servidor de informesReport server blocks

Para definir un servidor de informes, cree un bloque ReportServerWeb.To define a report server, you create a ReportServerWeb block. El rol del servidor de informes no es compatible con el servicio de extracción basado en SMB.The report server role is not compatible with SMB based pull service. ReportServerWeb define las siguientes propiedades.ReportServerWeb defines the following properties.

PropiedadProperty TipoType DescripciónDescription
AllowUnsecureConnectionAllowUnsecureConnection boolbool Establézcala en $TRUE para permitir conexiones desde el nodo al servidor sin autenticación.Set to $TRUE to allow connections from the node to the server without authentication. Establézcala en $FALSE para que se requiera autenticación.Set to $FALSE to require authentication.
CertificateIDCertificateID stringstring La huella digital de un certificado usado para autenticar el servidor.The thumbprint of a certificate used to authenticate to the server.
RegistrationKeyRegistrationKey stringstring Un GUID que identifica el nodo para el servicio de extracción.A GUID that identifies the node to the pull service.
ServerURLServerURL stringstring La dirección URL del servidor de configuración.The URL of the configuration server.
ProxyURL*ProxyURL* stringstring URL del proxy HTTP que se debe usar al conectar con el servicio de configuración.The URL of the http proxy to use when communicating with the configuration service.
ProxyCredential*ProxyCredential* PSCredentialpscredential Credencial que se debe usar para el proxy HTTP.Credential to use for the http proxy.

Nota

Se admite en Windows 1809 y versiones posteriores.Supported in Windows versions 1809 and later.

Hay disponible un script de ejemplo para simplificar la configuración del valor ReportServerWeb para los nodos locales, consulte el artículo sobre la configuración de metaconfiguraciones DSCAn example script to simplify configuring the ReportServerWeb value for on-premises nodes is available - see Generating DSC metaconfigurations

Configuraciones parcialesPartial configurations

Para definir una configuración parcial, cree un bloque PartialConfiguration.To define a partial configuration, you create a PartialConfiguration block. Para más información sobre configuraciones parciales, consulte Configuraciones parciales de DSC.For more information about partial configurations, see DSC Partial configurations. PartialConfiguration define las siguientes propiedades.PartialConfiguration defines the following properties.

PropiedadProperty TipoType DescripciónDescription
ConfigurationSourceConfigurationSource string[]string[] Una matriz de nombres de servidores de configuración, definidos previamente en bloques ConfigurationRepositoryWeb y ConfigurationRepositoryShare , desde donde se extrae la configuración parcial.An array of names of configuration servers, previously defined in ConfigurationRepositoryWeb and ConfigurationRepositoryShare blocks, where the partial configuration is pulled from.
DependsOnDependsOn string{}string{} Una lista de nombres de otras configuraciones que se deben completar antes de que se aplique esta configuración parcial.A list of names of other configurations that must be completed before this partial configuration is applied.
DescripciónDescription stringstring Texto utilizado para describir la configuración parcial.Text used to describe the partial configuration.
ExclusiveResourcesExclusiveResources string[]string[] Una matriz de recursos exclusivos de esta configuración parcial.An array of resources exclusive to this partial configuration.
RefreshModeRefreshMode stringstring Especifica cómo obtiene el LCM esta configuración parcial.Specifies how the LCM gets this partial configuration. Los valores posibles son "Disabled" , "Push" y "Pull" .The possible values are "Disabled" , "Push" , and "Pull".
  • Disabled : esta configuración parcial está deshabilitada.Disabled : This partial configuration is disabled.
  • Push : la configuración parcial se inserta en el nodo con una llamada al cmdlet Publish-DscConfiguration.Push : The partial configuration is pushed to the node by calling the Publish-DscConfiguration cmdlet. Cuando todas las configuraciones parciales del nodo se han insertado o extraído de un servicio, es posible iniciar la configuración con una llamada a Start-DscConfiguration –UseExisting.After all partial configurations for the node are either pushed or pulled from a service, the configuration can be started by calling Start-DscConfiguration –UseExisting. Este es el valor predeterminado.This is the default value.
  • Pull: el nodo se configura para comprobar con regularidad si existe una configuración parcial en un servicio de extracción.Pull: The node is configured to regularly check for partial configuration from a pull service. Si esta propiedad se establece en Pull , debe especificar un servicio de extracción en una propiedad ConfigurationSource.If this property is set to Pull , you must specify a pull service in a ConfigurationSource property. Para más información sobre el servicio de extracción de Azure Automation, consulte Información general de DSC de Azure Automation.For more information about Azure Automation pull service, see Azure Automation DSC Overview.
ResourceModuleSourceResourceModuleSource string[]string[] Una matriz de los nombres de los servidores de recursos desde los que se descargarán los recursos necesarios para esta configuración parcial.An array of the names of resource servers from which to download required resources for this partial configuration. Estos nombres deben hacer referencia a los puntos de conexión del servicio definidos previamente en los bloques ResourceRepositoryWeb y ResourceRepositoryShare.These names must refer to service endpoints previously defined in ResourceRepositoryWeb and ResourceRepositoryShare blocks.

Nota

Se admiten configuraciones parciales con Azure Automation DSC, pero solo se puede extraer una configuración de cada cuenta de automatización por nodo.partial configurations are supported with Azure Automation DSC, but only one configuration can be pulled from each automation account per node.

Consulte tambiénSee Also

ConceptosConcepts

Información de Desired State ConfigurationDesired State Configuration Overview

Introducción a DSC de Azure AutomationGetting started with Azure Automation DSC

Otros recursosOther Resources

Set-DscLocalConfigurationManagerSet-DscLocalConfigurationManager

Configuración de un cliente de extracción con nombres de configuraciónSetting up a pull client with configuration names