Partager via

Get-DscResource

  • Référence
Module:
PSDesiredStateConfiguration

Obtient les ressources DSC (Desired State Configuration) présentes sur l’ordinateur.

Syntaxe

Get-DscResource
   [[-Name] <String[]>]
   [[-Module] <Object>]
   [-Syntax]
   [<CommonParameters>]

Description

L’applet de commande Get-DscResource récupère les ressources DSC PowerShell présentes sur l’ordinateur. Cette applet de commande découvre uniquement les ressources installées dans PSModulePath. Il affiche les détails sur les fournisseurs intégrés et personnalisés, qui sont créés par l’utilisateur. Cette applet de commande affiche également des détails sur les ressources composites, qui sont d’autres configurations empaquetées en tant que module ou créées au moment de l’exécution dans la session.

Exemples

Exemple 1 : Obtenir toutes les ressources sur l’ordinateur local

Get-DscResource

Cette commande obtient toutes les ressources sur l’ordinateur local.

Exemple 2 : Obtenir une ressource en spécifiant le nom

Get-DscResource -Name "WindowsFeature"

Cette commande obtient la ressource WindowsFeature.

Exemple 3 : Obtenir toutes les ressources d’un module

Get-DscResource -Module "xHyper-V"

Cette commande obtient toutes les ressources du module xHyper-V.

Exemple 4 : Obtenir une ressource à l’aide de caractères génériques

Get-DscResource -Name P*,r*

Cette commande obtient toutes les ressources qui correspondent au modèle générique spécifié par le paramètre Name.

Exemple 5 : Obtenir une syntaxe de ressource

Get-DscResource -Name "WindowsFeature" -Syntax

Cette commande obtient la ressource WindowsFeature et affiche la syntaxe de la ressource.

Exemple 6 : Obtenir toutes les propriétés d’une ressource

Get-DscResource -Name "User" | Select-Object -ExpandProperty Properties

Cette commande obtient la ressource Utilisateur, puis utilise l’opérateur de pipeline pour retourner toutes les propriétés de la ressource Utilisateur.

Exemple 7 : Obtenir toutes les ressources d’un module spécifié avec une version spécifiée

Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}

Cette commande obtient toutes les ressources du module xHyper-V avec la version 3.0.0.0.

Paramètres

-Module

Spécifie le nom ou le nom complet du module pour lequel afficher la ressource DSC.

Type:Object
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie un tableau de noms de la ressource DSC à afficher.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Syntax

Indique que l’applet de commande retourne la vue de syntaxe des ressources DSC spécifiées. La syntaxe retournée montre comment utiliser les ressources dans un script PowerShell.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String[]

Object

Sorties

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]

Notes

  • Get-DscResource ne trouve pas les ressources DSC basées sur la classe dans les versions de PowerShell antérieures à la version 7.0.