Partager via


Find-DscResource

Recherche les ressources Desired State Configuration (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 dépôts inscrits pour rechercher les ressources DSC contenues dans les modules. Par défaut Find-DscResource , recherche tous les dépôts inscrits.

Il s’agit d’une applet de commande proxy pour l’applet Find-PSResourcede commande dans Microsoft.PowerShell.PSResourceGet. Pour plus d’informations, consultez Find-PSResource.

Exemples

Exemple 1 : 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 2 : Rechercher une ressource DSC et l’installer

Find-DscResource localise une ressource DSC et envoie l’objet dans le 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 à .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.

Paramètres

-AllowPrerelease

Inclut les ressources marquées en tant que préversion dans les résultats.

L’applet de commande proxy mappe ce paramètre au paramètre Prerelease de Find-PSResource.

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

-AllVersions

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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

-Filter

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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

-MaximumVersion

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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

-MinimumVersion

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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

-ModuleName

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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.

L’applet de commande proxy mappe ce paramètre au paramètre DscResourceName de Find-PSResource.

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

-Proxy

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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

-ProxyCredential

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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

-Repository

Spécifie un référentiel 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

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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

-Tag

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par le DscResourceNameParameterSet de Find-PSResource.

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

Le PowerShell Gallery ne prend plus en charge les versions 1.0 et 1.1 du protocole TLS (Transport Layer Security). Vous devez utiliser TLS 1.2 ou version ultérieure. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

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