Met behulp van resources met meerdere versiesUsing resources with multiple versions

Van toepassing op: Windows PowerShell 5.0Applies To: Windows PowerShell 5.0

In PowerShell 5.0 DSC-resources mogelijk meerdere versies en versies kunnen worden geïnstalleerd op een computer naast elkaar.In PowerShell 5.0, DSC resources can have multiple versions, and versions can be installed on a computer side-by-side. Dit wordt geïmplementeerd door meerdere versies van een resource-module die zijn opgenomen in dezelfde modulemap.This is implemented by having multiple versions of a resource module that are contained in the same module folder.

Installeren van meerdere resources versies side-by-sideInstalling multiple resource versions side-by-side

U kunt de MinimumVersion, MaximumVersion, en RequiredVersion parameters van de Install-Module cmdlet om op te geven welke versie van een module te installeren.You can use the MinimumVersion, MaximumVersion, and RequiredVersion parameters of the Install-Module cmdlet to specify which version of a module to install. Het aanroepen van Install-Module zonder op te geven met een versie installeert de meest recente versie.Calling Install-Module without specifying a version installs the most recent version.

Bijvoorbeeld: Er zijn meerdere versies van de xFailOverCluster -module, die een xCluster bron.For example, there are multiple versions of the xFailOverCluster module, each of which contains an xCluster resouce. Het resultaat van aanroepen Install-Module zonder op te geven van de versie nummer ziet er als volgt:The result of calling Install-Module without specifying the version number is as follows:

C:\Program Files\WindowsPowerShell\Modules\xFailOverCluster> Install-Module xFailOverCluster
C:\Program Files\WindowsPowerShell\Modules\xFailOverCluster> Get-DscResource xCluster

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

Als u nu Install-Module opnieuw, maar Geef een RequiredVersion van 1.1.0.0, resulteert dit in de volgende:Now, if you call Install-Module again, but specify a RequiredVersion of 1.1.0.0, it results in the following:

C:\Program Files\WindowsPowerShell\Modules\xFailOverCluster> Install-Module xFailOverCluster -RequiredVersion 1.1
C:\Program Files\WindowsPowerShell\Modules\xFailOverCluster> Get-DscResource xCluster

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

Een resourceversie opgeven in een configuratieSpecifying a resource version in a configuration

Als u meerdere resources die zijn geïnstalleerd op een computer hebt, moet u de versie van de bron opgeven wanneer u deze in een configuratie gebruikt.If you have multiple resources installed on a computer, you must specify the version of that resource when you use it in a configuration. U doet dit door geven de ModuleVersion parameter van de importeren DscResource sleutelwoord.You do this by specifying the ModuleVersion parameter of the Import-DscResource keyword. Als u niet de versie van een resource-module van een resource die u meer dan één versie geïnstalleerd hebt, wordt er een fout gegenereerd in de configuratie.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.

De volgende configuratie ziet u hoe de versie van de bron aan te roepen: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
        }
     }
}     

Opmerking: De parameter ModuleVersion van importeren DscResource is niet beschikbaar in PowerShell 4.0.Note: The ModuleVersion parameter of Import-DscResource is not available in PowerShell 4.0. In PowerShell 4.0, kunt u een moduleversie door een module specificatie-object doorgegeven aan de parameter ModuleName van importeren DscResource opgeven.In PowerShell 4.0, you can specify a module version by passing a module specification object to the ModuleName parameter of Import-DscResource. Een module-specificatie van het object is een hashtabel met ModuleName en RequiredVersion sleutels.A module specification object is a hash table that contains ModuleName and RequiredVersion keys. Bijvoorbeeld: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
        }
     }
}     

Dit werkt ook in PowerShell 5.0, maar het is raadzaam dat u de ModuleVersion parameter.This will also work in PowerShell 5.0, but it is recommended that you use the ModuleVersion parameter.

Zie ookSee also