Get-DscResource

  • Référence
Module:
PSDesiredStateConfiguration

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

Syntax

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

Description

L’applet Get-DscResource de commande récupère les ressources PowerShell DSC présentes sur l’ordinateur. Cette applet de commande détecte 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 sa syntaxe.

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

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

Cette commande obtient la ressource User, puis utilise l'opérateur pipeline pour retourner toutes ses propriétés.

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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

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

-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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String[]

Object

Sorties

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]