Partager via

Importer une version spécifique d’une ressource installée

  • Article

S’applique à : Windows PowerShell 5.0

Dans PowerShell 5.0, des versions distinctes des ressources DSC peuvent être installées sur un ordinateur côte à côte. Un module de ressources peut stocker des versions distinctes d’une ressource dans des dossiers nommés selon la version.

Installation de versions de ressources distinctes côte à côte

Vous pouvez utiliser les paramètres MinimumVersion, MaximumVersion et RequiredVersion de l’applet de commande Install-Module pour indiquer la version d’un module à installer. L’appel de l’applet de commande Install-Module sans spécifier de version installe la version la plus récente.

Par exemple, il existe plusieurs versions du module xFailOverCluster, chacun contenant une ressource xCluster. L’appel de l’applet de commande Install-Module sans spécifier de numéro de version installe la version la plus récente du module.

PS> Install-Module xFailOverCluster
PS> Get-DscResource xCluster

ImplementedAs   Name          ModuleName           Version    Properties
-------------   ----          ----------           -------    ----------
PowerShell      xCluster      xFailOverCluster     1.2.0.0    {DomainAdministratorCredential, ...

Pour installer une version spécifique d’un module, vous devez spécifier une version 1.1.0.0 de RequiredVersion. Cette opération installe la version spécifiée côte à côte avec la version installée.

PS> Install-Module xFailOverCluster -RequiredVersion 1.1

Vous voyez à présent les deux versions du module lorsque vous utilisez 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, ...

Spécification d’une version de ressource dans une configuration

Si des versions de ressources distinctes sont installées sur un ordinateur, vous devez spécifier la version d’une ressource quand vous l’utilisez dans une configuration. Pour cela, vous devez spécifier le paramètre ModuleVersion du mot-clé Import-DscResource. Si vous ne parvenez pas à spécifier la version d’un module d’une ressource dont plusieurs versions sont installées, la configuration génère une erreur.

La configuration suivante montre comment spécifier la version de la ressource à appeler :

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

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

le paramètre ModuleVersion d’Import-DscResource n’est pas disponible dans PowerShell 4.0. Dans PowerShell 4.0, vous pouvez spécifier une version du module en passant un objet de spécification de module au paramètre ModuleName d’Import-DscResource. Un objet de spécification de module est une table de hachage qui contient les clés ModuleName et RequiredVersion. Exemple :

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

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

Cela fonctionne également dans PowerShell 5.0, mais il est recommandé d’utiliser le paramètre ModuleVersion.

Voir aussi