Find-DscResource

Référence

Module:: PowerShellGet

Recherche Desired State Configuration ressources (DSC).

Syntax

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 Find-DscResource de commande recherche les référentiels inscrits pour rechercher les ressources DSC contenues dans les modules. Par défaut Find-DscResource , recherche tous les dépôts inscrits.

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

Exemples

Exemple 1 : Rechercher toutes les ressources DSC

Find-DscResource retourne des ressources DSC à partir de dépôts 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 son 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 spécifié de ressources DSC.

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 par le bas du pipeline au Install-Module. Install-Module tente d’installer le module une seule fois.

Find-DscResource -Name xWebsite | Install-Module

Find-DscResource utilise le paramètre Name pour rechercher la ressource nommée xWebsite. L’objet est envoyé vers le bas du pipeline à l’applet de Install-Module commande . Install-Module 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

Find-DscResource 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 être localisées à 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 dépôt. RequiredVersion a besoin du paramètre ModuleName et le 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

Find-DscResource recherche toutes les ressources et utilise le paramètre Filter 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 Select-Object de commande 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 des ressources marquées comme une préversion dans les résultats.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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ètres MinimumVersion, MaximumVersion ou RequiredVersion .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ModuleName

Spécifie un module qui contient la ressource DSC.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Proxy

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

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ProxyCredential

Spécifie un compte d’utilisateur autorisé à utiliser le serveur proxy spécifié dans le paramètre Proxy .

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Repository

Spécifie un dépôt pour rechercher des ressources. Utilisez des virgules pour séparer un tableau de noms de référentiels.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Sorties

PSGetDscResourceInfo

Find-DscResource retourne un objet PSGetDscResourceInfo .

Notes

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions 1.0 et 1.1 de Transport Layer Security (TLS). Si vous n'utilisez pas TLS 1.2 ou une version plus récente, vous recevez une erreur lorsque vous tentez d'accéder à 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 sur le blog PowerShell.

Partager via

Find-DscResource

Syntax

Description

Exemples

Exemple 1 : Rechercher toutes les ressources DSC

Exemple 2 : Rechercher une ressource DSC par son nom

Exemple 3 : Rechercher une ressource DSC et l’installer

Exemple 4 : Rechercher toutes les ressources DSC dans un module

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

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

Paramètres

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Sorties

Notes

Ressources supplémentaires

Partager via

Find-DscResource

Syntax

Description

Exemples

Exemple 1 : Rechercher toutes les ressources DSC

Exemple 2 : Rechercher une ressource DSC par son nom

Exemple 3 : Rechercher une ressource DSC et l’installer

Exemple 4 : Rechercher toutes les ressources DSC dans un module

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

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

Paramètres

-AllowPrerelease

-AllVersions

-Filter

-MaximumVersion

-MinimumVersion

-ModuleName

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

Sorties

Notes

Liens associés

Ressources supplémentaires