Partager via

Find-DscResource

Module:
PowerShellGet Module

Recherche les ressources DSC (Desired State Configuration).

Syntaxe

All 

Find-DscResource
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Description

L’applet de commande Find-DscResource recherche des référentiels inscrits pour rechercher les ressources DSC contenues dans les modules. Par défaut, Find-DscResource recherche tous les référentiels inscrits.

Pour chaque module trouvé par Find-DscResource, un objet PSGetDscResourceInfo est retourné. objets PSGetDscResourceInfo peuvent être envoyés dans le pipeline à l’applet de commande Install-Module. Install-Module installe le module.

Exemples

Exemple 1 : Rechercher toutes les ressources DSC

Find-DscResource retourne des ressources DSC à partir de référentiels inscrits. Pour effectuer une recherche dans un référentiel spécifique, utilisez le paramètre référentiel .

Find-DscResource

Name                           Version    ModuleName                     Repository
----                           -------    ----------                     ----------
Carbon_Privilege               2.8.1      Carbon                         PSGallery
Carbon_ScheduledTask           2.8.1      Carbon                         PSGallery
Carbon_Service                 2.8.1      Carbon                         PSGallery
PackageManagement              1.4        PackageManagement              PSGallery
PackageManagementSource        1.4        PackageManagement              PSGallery
PSModule                       2.1.4      PowerShellGet                  PSGallery
PSRepository                   2.1.4      PowerShellGet                  PSGallery
xArchive                       8.7.0.0    xPSDesiredStateConfiguration   PSGallery
xDSCWebService                 8.7.0.0    xPSDesiredStateConfiguration   PSGallery
xEnvironment                   8.7.0.0    xPSDesiredStateConfiguration   PSGallery

Exemple 2 : Rechercher une ressource DSC par nom

Find-DscResource localise les ressources DSC par nom. Utilisez des virgules pour séparer un tableau de noms de ressources.

Find-DscResource -Name xWebsite, xWebApplication, xWebSiteDefaults

Name               Version    ModuleName            Repository
----               -------    ----------            ----------
xWebApplication    2.6.0.0    xWebAdministration    PSGallery
xWebsite           2.6.0.0    xWebAdministration    PSGallery
xWebSiteDefaults   2.6.0.0    xWebAdministration    PSGallery

Find-DscResource utilise le paramètre Name pour rechercher le tableau de ressources DSC spécifié.

Exemple 3 : Rechercher une ressource DSC et l’installer

Find-DscResource localise une ressource DSC et envoie l’objet vers le bas du pipeline à installer. Après l’installation, utilisez Get-InstalledModule pour afficher les résultats.

Plusieurs ressources du même module peuvent être envoyées au pipeline vers le Install-Module. Install-Module tente d’installer le module une seule fois.

Find-DscResource -Name xWebsite | Install-Module

utilise le paramètre Name pour rechercher la ressource nommée xWebsite . L’objet est envoyé vers le bas du pipeline à l’applet Install-Module de commande. installe le module xWebAdministration pour la ressource.

Exemple 4 : Rechercher toutes les ressources DSC dans un module

Find-DscResource recherche toutes les ressources DSC contenues dans un module spécifié. Par défaut, la version actuelle s’affiche. Pour afficher d’autres versions, utilisez les paramètres AllVersions ou RequiredVersions.

Find-DscResource -ModuleName xWebAdministration

Name                                Version    ModuleName              Repository
----                                -------    ----------              ----------
WebApplicationHandler               2.6.0.0    xWebAdministration      PSGallery
xIisFeatureDelegation               2.6.0.0    xWebAdministration      PSGallery
xIisHandler                         2.6.0.0    xWebAdministration      PSGallery
xIisLogging                         2.6.0.0    xWebAdministration      PSGallery

utilise le paramètre ModuleName pour spécifier le xWebAdministration et rechercher les ressources DSC contenues dans le module. La version actuelle de chaque ressource s’affiche.

Exemple 5 : Rechercher une ressource DSC par balise et version requise

Les ressources DSC peuvent se trouver à l’aide des paramètres Tag et RequiredVersion. balise affiche la version actuelle de chaque ressource qui contient la balise spécifiée dans le référentiel. RequiredVersion a besoin du paramètre ModuleName et du paramètre Name est facultatif. Les paramètres Name et ModuleName limitent la sortie. Utilisez le paramètre AllVersions pour afficher les versions disponibles d’une ressource DSC.

Find-DscResource -ModuleName xWebAdministration -Tag DSC -RequiredVersion 1.20

Name                    Version    ModuleName             Repository
----                    -------    ----------             ----------
xIisFeatureDelegation   1.20.0.0   xWebAdministration     PSGallery
xIisHandler             1.20.0.0   xWebAdministration     PSGallery
xIisLogging             1.20.0.0   xWebAdministration     PSGallery
xIisMimeTypeMapping     1.20.0.0   xWebAdministration     PSGallery

Exemple 6 : Rechercher une ressource à l’aide d’un filtre

recherche toutes les ressources et utilise le paramètre de filtre de pour spécifier les résultats par domaine. Le paramètre Filter recherche la valeur de filtre dans la description ou le nom du module de l’objet. Utilisez l’applet de commande Select-Object pour afficher les propriétés d’un objet.

Find-DscResource -Filter Domain

Name                    Version    ModuleName                 Repository
----                    -------    ----------                 ---------
xComputer               4.1.0.0    xComputerManagement        PSGallery
Computer                6.4.0.0    ComputerManagementDsc      PSGallery
xDSCDomainjoin          1.1        xDSCDomainjoin             PSGallery
xDisk                   1.0        xDisk                      PSGallery
xDSCFirewall            1.6.21     xDSCFirewall               PSGallery
dmAwsTagInstance        1.0.1      domainAwsDSCResources      PSGallery

Paramètres

-AllowPrerelease

Inclut les ressources marquées comme une préversion dans les résultats.

Propriétés des paramètres

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AllVersions

Le paramètre AllVersions affiche chacune des versions disponibles d’une ressource DSC. Vous ne pouvez pas utiliser le paramètre AllVersions avec les paramètresMinimumVersion , MaximumVersionou RequiredVersion.

Propriétés des paramètres

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Filter

Recherche les ressources en fonction de la syntaxe de recherche du fournisseur PackageManagement. Par exemple, spécifiez des mots à rechercher dans les propriétés moduleName et Description.

Propriétés des paramètres

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaximumVersion

Spécifie la version maximale de la ressource à inclure dans les résultats. Les MaximumVersion et les paramètres RequiredVersion ne peuvent pas être utilisés dans la même commande.

Propriétés des paramètres

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MinimumVersion

Spécifie la version minimale de la ressource à inclure dans les résultats. Les MinimumVersion et les paramètres RequiredVersion ne peuvent pas être utilisés dans la même commande.

Propriétés des paramètres

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ModuleName

Spécifie un module qui contient la ressource DSC.

Propriétés des paramètres

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Spécifie le nom d’une ressource. La valeur par défaut est toutes les ressources. Utilisez des virgules pour séparer un tableau de noms de ressources.

Propriétés des paramètres

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Proxy

Spécifie un serveur proxy pour la requête, plutôt qu’une connexion directe à la ressource Internet.

Propriétés des paramètres

Type:Uri
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ProxyCredential

Spécifie un compte d’utilisateur avec l’autorisation d’utiliser le serveur proxy spécifié dans le paramètre proxy .

Propriétés des paramètres

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Repository

Spécifie un référentiel à rechercher des ressources. Utilisez des virgules pour séparer un tableau de noms de référentiels.

Propriétés des paramètres

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RequiredVersion

Spécifie le numéro de version exact du module à inclure dans les résultats. Les RequiredVersion et les paramètres MinimumVersion ne peuvent pas être utilisés dans la même commande.

Propriétés des paramètres

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Tag

Spécifie des balises qui classent les modules dans un référentiel. Utilisez des virgules pour séparer un tableau de balises.

Propriétés des paramètres

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

PSGetDscResourceInfo

Find-DscResource renvoie un objet PSGetDscResourceInfo.

Notes

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Si vous n’utilisez pas TLS 1.2 ou version ultérieure, vous recevez une erreur lors de la tentative d’accès à PowerShell Gallery. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Pour plus d’informations, consultez l’annonce dans le blog PowerShell.