Importación de una versión específica de un recurso instalado

  • Artículo

Se aplica a: Windows PowerShell 5.0

En PowerShell 5.0, se pueden instalar versiones independientes de recursos de DSC en un equipo en paralelo. Un módulo de recursos puede almacenar versiones independientes de un recurso en carpetas denominadas de versión.

Instalación de versiones de recursos independientes en paralelo

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. Llamar a Install-Module sin especificar una versión instala la versión más reciente.

Por ejemplo, hay varias versiones del módulo xFailOverCluster, cada una de las cuales contiene un recurso xCluster. La llamada a Install-Module sin especificar el número de versión instala la versión más reciente del módulo.

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. Esto instala la versión especificada en paralelo con la versión instalada.

PS> Install-Module xFailOverCluster -RequiredVersion 1.1

Ahora, puede ver ambas versiones del módulo enumeradas al utilizar 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ón

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. Esto se hace mediante la especificación del parámetro ModuleVersion de la palabra clave Import-DscResource. 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.

La configuración siguiente muestra cómo especificar la versión del recurso al que se va a llamar:

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. 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. Un objeto de especificación de módulo es una tabla hash que contiene las claves ModuleName y RequiredVersion. Por ejemplo:

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.

Consulte también