Importación de una versión específica de un recurso instaladoImport a specific version of an installed resource

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

En PowerShell 5.0, se pueden instalar versiones independientes de recursos de DSC en un equipo en paralelo.In PowerShell 5.0, separate versions of DSC resources can be installed on a computer side by side. Un módulo de recursos puede almacenar versiones independientes de un recurso en carpetas denominadas de versión.A resource module can store separate versions of a resource in version named folders.

Instalación de versiones de recursos independientes en paraleloInstalling separate resource versions side by side

Puede usar los parámetros MinimumVersion , MaximumVersion y RequiredVersion del cmdlet Install-Module para especificar la versión de un módulo que se va a instalar.You can use the MinimumVersion , MaximumVersion , and RequiredVersion parameters of the Install-Module cmdlet to specify which version of a module to install. Llamar a Install-Module sin especificar una versión instala la versión más reciente.Calling Install-Module without specifying a version installs the most recent version.

Por ejemplo, hay varias versiones del módulo xFailOverCluster , cada una de las cuales contiene un recurso xCluster.For example, there are multiple versions of the xFailOverCluster module, each of which contains an xCluster resource. La llamada a Install-Module sin especificar el número de versión instala la versión más reciente del módulo.Calling Install-Module without specifying the version number installs the most recent version of the module.

PS> Install-Module xFailOverCluster
PS> Get-DscResource xCluster
ImplementedAs   Name          ModuleName           Version    Properties
-------------   ----          ----------           -------    ----------
PowerShell      xCluster      xFailOverCluster     1.2.0.0    {DomainAdministratorCredential, ...

Para instalar una versión específica de un módulo, especifique un valor para RequiredVersion de 1.1.0.0.To install a specific version of a module, specify a RequiredVersion of 1.1.0.0. Esto instala la versión especificada en paralelo con la versión instalada.This installs the specified version side by side with the installed version.

PS> Install-Module xFailOverCluster -RequiredVersion 1.1

Ahora, puede ver ambas versiones del módulo enumeradas al utilizar Get-DSCResource.Now, you see both version of the module listed when you use Get-DSCResource.

PS> Get-DscResource xCluster
ImplementedAs   Name          ModuleName            Version    Properties
-------------   ----          ----------            -------    ----------
PowerShell      xCluster      xFailOverCluster      1.1        {DomainAdministratorCredential, Name, ...
PowerShell      xCluster      xFailOverCluster      1.2.0.0    {DomainAdministratorCredential, Name, ...

Especificación de una versión de recursos en una configuraciónSpecifying a resource version in a configuration

Si tiene varias versiones de recursos instaladas en un equipo, debe especificar la versión de ese recurso cuando lo usa en una configuración.If you have separate resource versions installed on a computer, you must specify the version of that resource when you use it in a configuration. Esto se hace mediante la especificación del parámetro ModuleVersion de la palabra clave Import-DscResource.You do this by specifying the ModuleVersion parameter of the Import-DscResource keyword. Si tiene instaladas varias versiones de un recurso y no especifica la versión del módulo de recursos que quiere usar, la configuración generará un error.If you fail to specify the version of a resource module of a resource of which you have more than one version installed, the configuration generates an error.

La configuración siguiente muestra cómo especificar la versión del recurso al que se va a llamar:The following configuration shows how to specify the version of the resource to call:

configuration VersionTest
{
    Import-DscResource -ModuleName xFailOverCluster -ModuleVersion 1.1

    Node 'localhost'
    {
       xCluster ClusterTest
       {
            Name                          = 'TestCluster'
            StaticIPAddress               = '10.0.0.3'
            DomainAdministratorCredential = Get-Credential
        }
     }
}

El parámetro ModuleVersion de Import-DscResource no está disponible en PowerShell 4.0.The ModuleVersion parameter of Import-DscResource is not available in PowerShell 4.0. En PowerShell 4.0, puede especificar una versión de módulo pasando un objeto de especificación de módulo al parámetro ModuleName de Import-DscResource.In PowerShell 4.0, you can specify a module version by passing a module specification object to the ModuleName parameter of Import-DscResource. Un objeto de especificación de módulo es una tabla hash que contiene las claves ModuleName y RequiredVersion.A module specification object is a hash table that contains ModuleName and RequiredVersion keys. Por ejemplo:For example:

configuration VersionTest
{
    Import-DscResource -ModuleName (@{ModuleName='xFailOverCluster'; RequiredVersion='1.1'} )

    Node 'localhost'
    {
       xCluster ClusterTest
       {
            Name                          = 'TestCluster'
            StaticIPAddress               = '10.0.0.3'
            DomainAdministratorCredential = Get-Credential
        }
     }
}

Esto también funcionará en PowerShell 5.0, pero se recomienda que use el parámetro ModuleVersion.This will also work in PowerShell 5.0, but it is recommended that you use the ModuleVersion parameter.

Consulte tambiénSee also