NOM
Get-Module
RÉSUMÉ
Obtient les modules qui ont été importés ou peuvent être importés dans la session active.
SYNTAXE
Get-Module [-All] [-ListAvailable] [-Name <string[]>] [<CommonParameters>]
Get-Module [[-Name] <string[]>] [<CommonParameters>]
DESCRIPTION
L'applet de commande Get-Module obtient les modules qui ont été importés ou peuvent être importés dans la session.
Get-Module permet d'obtenir les modules, mais pas de les importer. Pour importer les modules dans votre session, utilisez Import-Module.
PARAMÈTRES
-All [<SwitchParameter>]
Obtient des objets de module pour tous les fichiers de module.
Sans le paramètre All, Get-Module obtient uniquement l'objet de module du fichier de module par défaut. L'applet de commande sélectionne les types de fichiers dans l'ordre suivant : fichiers manifestes (.psd1), fichiers de module de script (.psm1) et fichiers de module binaire (.dll).
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ListAvailable [<SwitchParameter>]
Obtient tous les modules qui peuvent être importés dans la session. Get-Module place les modules dans les chemins d'accès spécifiés par la variable d'environnement $env:PSModulePath.
Sans ce paramètre, Get-Module obtient uniquement les modules importés dans la session.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Name <string[]>
Obtient uniquement les modules ayant les noms ou modèles de nom spécifiés. Les caractères génériques sont autorisés. Vous pouvez également diriger les noms vers Get-Module.
Obligatoire ? false
Position ? 1
Valeur par défaut Tous les modules importés ou disponibles.
Accepter l'entrée de pipeline ? true (ByValue)
Accepter les caractères génériques ? true
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
System.String
Vous pouvez diriger les noms de modules vers Get-Module.
SORTIES
System.Management.Automation.PSModuleInfo
Get-Module retourne les objets qui représentent les modules.
NOTES
Vous pouvez également faire référence à Get-Module par son alias, « gmo ». Pour plus d'informations, consultez about_Aliases.
Le paramètre All retourne des objets de module pour tous les fichiers comportant l'extension .dll, même s'ils n'implémentent pas des applets de commande ou des fournisseurs.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>get-module
Description
-----------
Cette commande obtient les modules importés dans la session active.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>get-module -listAvailable
Description
-----------
Cette commande obtient les modules qui peuvent être importés dans la session active.
Get-Module recherche des modules disponibles dans le chemin d'accès spécifié par la variable d'environnement $env:PSModulePath. Pour plus d'informations sur PSModulePath, consultez about_Modules et about_Environment_Variables.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>get-module -listAvailable -all
Description
-----------
Cette commande obtient tous les fichiers exportés pour tous les modules disponibles.
-------------------------- EXEMPLE 4 --------------------------
C:\PS>get-module | get-member -type property
TypeName: System.Management.Automation.PSModuleInfo
Name MemberType Definition
---- ---------- ----------
AccessMode Property System.Management.Automation.ModuleAcc
Description Property System.String Description {get;set;}
ExportedAliases Property System.Collections.Generic.Dictionary`
ExportedCmdlets Property System.Collections.Generic.Dictionary`
ExportedFunctions Property System.Collections.Generic.Dictionary`
ExportedVariables Property System.Collections.Generic.Dictionary`
Guid Property System.Guid Guid {get;}
ModuleBase Property System.String ModuleBase {get;}
ModuleType Property System.Management.Automation.ModuleTyp
Name Property System.String Name {get;}
NestedModules Property System.Collections.ObjectModel.ReadOnl
OnRemove Property System.Management.Automation.ScriptBlo
Path Property System.String Path {get;}
PrivateData Property System.Object PrivateData {get;set;}
SessionState Property System.Management.Automation.SessionSt
Version Property System.Version Version {get;}
Description
-----------
Cette commande obtient les propriétés de l'objet PSModuleInfo que Get-Module retourne. Il y a un objet pour chaque fichier module.
Vous pouvez utiliser les propriétés pour mettre en forme et filtrer les objets de module. Pour plus d'informations sur les propriétés, consultez « Propriétés PSModule » (page éventuellement en anglais) dans la bibliothèque MSDN (Microsoft Developer Network) à l'adresse http://go.microsoft.com/fwlink/?LinkId=143624.
-------------------------- EXEMPLE 5 --------------------------
C:\PS>get-module -listAvailable -all | format-table -property name, moduletype, path -groupby name -auto
Name: MyTestCmdlets
Name ModuleType Path
---- ---------- ----
MyTestCmdlets Script C:\Windows\system32\WindowsPowerShell\v1.0\Modules\TestCmdlets\TestCmdlets.dll
Name: PSDiagnostics
Name ModuleType Path
---- ---------- ----
PSDiagnostics Manifest C:\Windows\system32\WindowsPowerShell\v1.0\Modules\PSDiagnostics\PSDiagnostics.psd1
PSDiagnostics Script C:\Windows\system32\WindowsPowerShell\v1.0\Modules\PSDiagnostics\PSDiagnostics.psm1
Name: FileTransfer
Name ModuleType Path
---- ---------- ----
FileTransfer Manifest C:\Windows\system32\WindowsPowerShell\v1.0\Modules\FileTransfer\FileTransfer.psd1
Description
-----------
Cette commande obtient tous les fichiers de module (importés et disponibles) et les regroupe par nom de module. Cela vous permet de consulter les fichiers de module que chaque script exporte.
-------------------------- EXEMPLE 6 --------------------------
C:\PS>$m = get-module -list -name FileTransfer | where {$_.moduletype -eq "Manifest"}
C:\PS> get-content $m.path
@{
GUID="{8FA5064B-8479-4c5c-86EA-0D311FE48875}"
Author="Microsoft Corporation"
CompanyName="Microsoft Corporation"
Copyright="© Microsoft Corporation. All rights reserved."
ModuleVersion="1.0.0.0"
Description="Windows Powershell File Transfer Module"
PowerShellVersion="2.0"
CLRVersion="2.0"
NestedModules="Microsoft.BackgroundIntelligentTransfer.Management"
FormatsToProcess="FileTransfer.Format.ps1xml"
RequiredAssemblies=Join-Path $psScriptRoot "Microsoft.BackgroundIntelligentTransfer.Management.Interop.dll"
}
Description
-----------
Ces commandes affichent le contenu du manifeste de module pour le module Windows PowerShell File Transfer.
La première commande obtient l'objet PSModuleInfo qui représente le manifeste de module pour le module File Transfer. Il enregistre l'objet dans la variable $m.
La deuxième commande utilise la notation par points pour décrire le chemin d'accès au fichier manifeste stocké dans la propriété Path de l'objet. Ensuite, elle utilise l'applet de commande Get-Content pour obtenir le contenu du fichier manifeste dans le chemin d'accès spécifié.
Les modules ne doivent pas nécessairement comporter des fichiers manifestes. Lorsqu'ils en comportent un, le manifeste est requis uniquement pour inclure un numéro de version. Toutefois, les fichiers manifestes fournissent souvent les informations utiles sur un module, ses exigences et son contenu.
-------------------------- EXEMPLE 7 --------------------------
C:\PS>get-module -listAvailable -name FileTransfer | format-list -property *
Name : FileTransfer
Path : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\FileTransfer\FileTransfer.psd1
Description : Powershell File Transfer Module
Guid : 8fa5064b-8479-4c5c-86ea-0d311fe48875
ModuleBase : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\FileTransfer
PrivateData :
Version : 1.0.0.0
ModuleType : Manifest
AccessMode : ReadWrite
ExportedFunctions : {}
ExportedCmdlets : {}
NestedModules : {}
ExportedVariables : {}
ExportedAliases : {}
SessionState : System.Management.Automation.SessionState
OnRemove :
Description
-----------
Cette commande affiche toutes les propriétés du module FileTransfer dans une liste.
Parce que le module n'a pas encore été importé dans la session, les propriétés Exported* et la propriété NestedModules ne sont pas encore remplies. Ces propriétés sont remplies uniquement une fois que les éléments ont été exportés et que les modules imbriqués ont été instanciés.
-------------------------- EXEMPLE 8 --------------------------
C:\PS>dir (get-module -listavailable FileTransfer).modulebase
Directory: C:\Windows\system32\WindowsPowerShell\v1.0\Modules\FileTransfer
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 12/16/2008 12:36 PM en-US
-a--- 11/19/2008 11:30 PM 16184 FileTransfer.Format.ps1xml
-a--- 11/20/2008 11:30 PM 1044 FileTransfer.psd1
-a--- 12/16/2008 12:20 AM 108544 Microsoft.BackgroundIntelligentTransfer.Management.Interop.dll
Description
-----------
Cette commande répertorie les fichiers contenus dans le répertoire du module. C'est une autre façon de déterminer ce que contient un module avant de l'importer. Certains modules peuvent contenir des fichiers d'aide ou des fichiers ReadMe qui le décrivent.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=141552
Import-Module
New-Module
Remove-Module
about_Modules
Aucun commentaire:
Enregistrer un commentaire