Import-PSSession
Importe des commandes à partir d'une autre session dans la session active.
Syntax
Import-PSSession
[-Prefix <String>]
[-DisableNameChecking]
[[-CommandName] <String[]>]
[-AllowClobber]
[-ArgumentList <Object[]>]
[-CommandType <CommandTypes>]
[-Module <String[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[[-FormatTypeName] <String[]>]
[-Certificate <X509Certificate2>]
[-Session] <PSSession>
[<CommonParameters>]Description
L’applet Import-PSSession de commande importe des commandes, telles que des applets de commande, des fonctions et des alias, à partir d’une session PSSession sur un ordinateur local ou distant dans la session active. Vous pouvez importer n’importe quelle commande que l’applet Get-Command de commande peut trouver dans la session PSSession.
Utilisez une Import-PSSession commande pour importer des commandes à partir d’un interpréteur de commandes personnalisé, tel qu’un interpréteur de commandes Microsoft Exchange Server, ou à partir d’une session qui inclut des modules Windows PowerShell et des composants logiciels enfichables ou d’autres éléments qui ne figurent pas dans la session active.
Pour importer des commandes, utilisez d’abord l’applet New-PSSession de commande pour créer une session PSSession. Utilisez ensuite l’applet Import-PSSession de commande pour importer les commandes. Par défaut, importe toutes les commandes à Import-PSSession l’exception des commandes qui ont le même nom que les commandes dans la session active. Pour importer toutes les commandes, utilisez le paramètre AllowClobber .
Vous pouvez utiliser des commandes importées comme vous utiliseriez n'importe quelle commande de la session. Quand vous utilisez une commande importée, la partie importée de la commande s'exécute implicitement dans la session à partir de laquelle elle a été importée. Toutefois, les opérations à distance sont gérées entièrement par Windows PowerShell. Vous ne devez même pas vous en rendre compte, sauf que vous devez conserver la connexion à l'autre session (PSSession) ouverte. Si vous la fermez, les commandes importées ne sont plus disponibles.
Étant donné que les commandes importées peuvent prendre plus de temps que les commandes locales, Import-PSSession ajoutez un paramètre AsJob à chaque commande importée. Ce paramètre vous permet d'exécuter la commande en tant que tâche en arrière-plan Windows PowerShell. Pour plus d’informations, consultez à propos des_tâches.
Lorsque vous utilisez Import-PSSession, Windows PowerShell ajoute les commandes importées à un module temporaire qui existe uniquement dans votre session et retourne un objet qui représente le module. Pour créer un module persistant que vous pouvez utiliser dans les sessions ultérieures, utilisez l’applet de Export-PSSession commande.
L’applet Import-PSSession de commande utilise la fonctionnalité de communication à distance implicite de Windows PowerShell. Quand vous importez des commandes dans la session active, elles s'exécutent implicitement dans la session d'origine ou dans une session similaire sur l'ordinateur d'origine.
À compter de Windows PowerShell 3.0, vous pouvez utiliser l’applet Import-Module de commande pour importer des modules à partir d’une session distante dans la session active. Cette fonctionnalité utilise la communication à distance implicite. Il équivaut à utiliser Import-PSSession pour importer des modules sélectionnés à partir d’une session distante dans la session active.
Exemples
Exemple 1 : Importer toutes les commandes à partir d’une session PSSession
$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $SCette commande importe toutes les commandes d'une session PSSession sur l'ordinateur Server01 dans la session active, à l'exception des commandes qui ont le même nom que les commandes dans la session active.
Étant donné que cette commande n’utilise pas le paramètre CommandName , elle importe également toutes les données de mise en forme requises pour les commandes importées.
Exemple 2 : Importer des commandes qui se terminent par une chaîne spécifique
$S = New-PSSession https://ps.testlabs.com/powershell
Import-PSSession -Session $S -CommandName *-test -FormatTypeName *
New-Test -Name Test1
Get-Test test1 | Run-TestCes commandes importent les commandes dont les noms se terminent par « -test » à partir d'une session PSSession dans la session locale, puis indiquent comment utiliser une applet de commande importée.
La première commande utilise l’applet New-PSSession de commande pour créer une session PSSession. Il enregistre la session PSSession dans la $S variable.
La deuxième commande utilise l’applet Import-PSSession de commande pour importer des commandes à partir de la session PSSession dans $S la session active. Il utilise le paramètre CommandName pour spécifier des commandes avec le nom test et le paramètre FormatTypeName pour importer les données de mise en forme des commandes test.
Les troisième et quatrième commandes utilisent les commandes importées dans la session active. Comme les commandes importées sont en réalité ajoutées à la session active, vous utilisez la syntaxe locale pour les exécuter. Vous n’avez pas besoin d’utiliser l’applet Invoke-Command de commande pour exécuter une commande importée.
Exemple 3 : Importer des applets de commande à partir d’une session PSSession
$S1 = New-PSSession -ComputerName s1
$S2 = New-PSSession -ComputerName s2
Import-PSSession -Session s1 -Type cmdlet -Name New-Test, Get-Test -FormatTypeName *
Import-PSSession -Session s2 -Type Cmdlet -Name Set-Test -FormatTypeName *
New-Test Test1 | Set-Test -RunType FullCet exemple montre que vous pouvez utiliser les applets de commande importées comme vous utiliseriez des applets de commande locales.
Ces commandes importent les New-Test applets de commande et Get-Test les applets de commande à partir d’une session PSSession sur l’ordinateur Server01 et de l’applet Set-Test de commande à partir d’une session PSSession sur l’ordinateur Server02.
Même si les applets de commande ont été importées à partir de différentes sessions PSSession, vous pouvez diriger un objet d'une applet de commande vers une autre sans erreur.
Exemple 4 : Exécuter une commande importée en tant que travail en arrière-plan
$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S -CommandName *-test* -FormatTypeName *
$batch = New-Test -Name Batch -AsJob
Receive-Job $batchCet exemple montre comment exécuter une commande importée en tant que tâche en arrière-plan.
Étant donné que les commandes importées peuvent prendre plus de temps que les commandes locales, Import-PSSession ajoutez un paramètre AsJob à chaque commande importée. Le paramètre AsJob vous permet d’exécuter la commande en tant que travail en arrière-plan.
La première commande crée une session PSSession sur l’ordinateur Server01 et enregistre l’objet PSSession dans la $S variable.
La deuxième commande utilise Import-PSSession pour importer les applets de commande test à partir de la session PSSession dans $S la session active.
La troisième commande utilise le paramètre AsJob de l’applet de commande importée New-Test pour exécuter une New-Test commande en tant que travail en arrière-plan. La commande enregistre l’objet de travail qui New-Test retourne dans la $batch variable.
La quatrième commande utilise l’applet Receive-Job de commande pour obtenir les résultats du travail dans la $batch variable.
Exemple 5 : Importer des applets de commande et des fonctions à partir d’un module Windows PowerShell
$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S {Import-Module TestManagement}
Import-PSSession -Session $S -Module TestManagementCet exemple montre comment importer les applets de commande et fonctions à partir d'un module Windows PowerShell sur un ordinateur distant dans la session active.
La première commande crée une session PSSession sur l’ordinateur Server01 et l’enregistre dans la $S variable.
La deuxième commande utilise l’applet Invoke-Command de commande pour exécuter une Import-Module commande dans la session PSSession dans $S.
En règle générale, le module est ajouté à toutes les sessions par une Import-Module commande dans un profil Windows PowerShell, mais les profils ne sont pas exécutés dans psSessions.
La troisième commande utilise le paramètre Module de l’importation des applets de Import-PSSession commande et des fonctions dans le module dans la session active.
Exemple 6 : Créer un module dans un fichier temporaire
PS C:\> Import-PSSession $S -CommandName Get-Date, SearchHelp -FormatTypeName * -AllowClobber
Name : tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
Path : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1
zunz.ttf\tmp_79468106-4e1d-4d90-af97-1154f9317239_
tcw1zunz.ttf.psm1
Description : Implicit remoting for http://server01.corp.fabrikam.com/wsman
Guid : 79468106-4e1d-4d90-af97-1154f9317239
Version : 1.0
ModuleBase : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1
zunz.ttf
ModuleType : Script
PrivateData : {ImplicitRemoting}
AccessMode : ReadWrite
ExportedAliases : {}
ExportedCmdlets : {}
ExportedFunctions : {[Get-Date, Get-Date], [SearchHelp, SearchHelp]}
ExportedVariables : {}
NestedModules : {}Cet exemple montre comment Import-PSSession créer un module dans un fichier temporaire sur le disque. Il montre également que toutes les commandes sont converties en fonctions avant leur importation dans la session active.
La commande utilise l’applet Import-PSSession de commande pour importer une Get-Date applet de commande et une fonction SearchHelp dans la session active.
L’applet Import-PSSession de commande retourne un objet PSModuleInfo qui représente le module temporaire. La valeur de la propriété Path montre qu’un Import-PSSession fichier de module de script (.psm1) a été créé dans un emplacement temporaire. La propriété ExportFunctions indique que l’applet de commande et la Get-Date fonction SearchHelp ont tous deux été importés en tant que fonctions.
Exemple 7 : Exécuter une commande masquée par une commande importée
PS C:\> Import-PSSession $S -CommandName Get-Date -FormatTypeName * -AllowClobber
PS C:\> Get-Command Get-Date -All
CommandType Name Definition
----------- ---- ----------
Function Get-Date ...
Cmdlet Get-Date Get-Date [[-Date] <DateTime>] [-Year <Int32>] [-Month <Int32>]
PS C:\> Get-Date
09074
PS C:\> (Get-Command -Type Cmdlet -Name Get-Date).PSSnapin.Name
Microsoft.PowerShell.Utility
PS C:\> Microsoft.PowerShell.Utility\Get-Date
Sunday, March 15, 2009 2:08:26 PMCet exemple montre comment exécuter une commande qui est masquée par une commande importée.
La première commande importe une Get-Date applet de commande à partir de la session PSSession dans la $S variable. Étant donné que la session active inclut une Get-Date applet de commande, le paramètre AllowClobber est requis dans la commande.
La deuxième commande utilise le paramètre All de l’applet Get-Command de commande pour obtenir toutes les Get-Date commandes de la session active. La sortie indique que la session inclut l’applet de commande d’origine Get-Date et une Get-Date fonction. La Get-Date fonction exécute l’applet de commande importée Get-Date dans psSession dans $S.
La troisième commande exécute une Get-Date commande. Étant donné que les fonctions sont prioritaires sur les applets de commande, Windows PowerShell exécute la fonction importée Get-Date , qui retourne une date julian.
Les quatrième et cinquième commandes montrent comment utiliser un nom qualifié pour exécuter une commande qui est masquée par une commande importée.
La quatrième commande obtient le nom du composant logiciel enfichable Windows PowerShell qui a ajouté l’applet de commande d’origine Get-Date à la session active.
La cinquième commande utilise le nom qualifié enfichable de l’applet Get-Date de commande pour exécuter une Get-Date commande.
Pour plus d’informations sur la priorité des commandes et les commandes masquées, consultez about_Command_Precedence.
Exemple 8 : Importer des commandes qui ont une chaîne spécifique dans leurs noms
PS C:\> Import-PSSession -Session $S -CommandName **Item** -AllowClobberCette commande importe les commandes dont les noms incluent Item à partir de la session PSSession dans $S. Étant donné que la commande inclut le paramètre CommandName , mais pas le paramètre FormatTypeData , seule la commande est importée.
Utilisez cette commande lorsque vous utilisez Import-PSSession pour exécuter une commande sur un ordinateur distant et que vous disposez déjà des données de mise en forme de la commande dans la session active.
Exemple 9 : Utiliser le paramètre Module pour découvrir les commandes qui ont été importées dans la session
PS C:\> $M = Import-PSSession -Session $S -CommandName *bits* -FormatTypeName *bits*
PS C:\> Get-Command -Module $M
CommandType Name
----------- ----
Function Add-BitsFile
Function Complete-BitsTransfer
Function Get-BitsTransfer
Function Remove-BitsTransfer
Function Resume-BitsTransfer
Function Set-BitsTransfer
Function Start-BitsTransfer
Function Suspend-BitsTransferCette commande montre comment utiliser le paramètre Module pour Get-Command savoir quelles commandes ont été importées dans la session par une Import-PSSession commande.
La première commande utilise l’applet Import-PSSession de commande pour importer des commandes dont les noms incluent des « bits » à partir de la session PSSession dans la $S variable. La Import-PSSession commande retourne un module temporaire et la commande enregistre le module dans la $m variable.
La deuxième commande utilise l’applet Get-Command de commande pour obtenir les commandes exportées par le module dans la $M variable.
Le paramètre Module prend une valeur de chaîne, qui est conçue pour le nom du module. Toutefois, lorsque vous envoyez un objet de module, Windows PowerShell utilise la méthode ToString sur l’objet module, qui retourne le nom du module.
La Get-Command commande est l’équivalent de Get-Command $M.Name».
Paramètres
-AllowClobber
Indique que cette applet de commande importe les commandes spécifiées, même si elles ont les mêmes noms que les commandes dans la session active.
Si vous importez une commande portant le même nom qu'une commande dans la session active, la commande importée masque ou remplace les commandes d'origine. Pour plus d’informations, consultez about_Command_Precedence.
Par défaut, Import-PSSession n’importe pas les commandes qui ont le même nom que les commandes dans la session active.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ArgumentList
Spécifie un tableau de commandes résultant de l’utilisation des arguments spécifiés (valeurs de paramètre).
Par exemple, pour importer la variante de la Get-Item commande dans le lecteur de certificat (Cert :) dans la session PSSession dans $S, tapez Import-PSSession -Session $S -Command Get-Item -ArgumentList cert:.
| Type: | Object[] |
| Aliases: | Args |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Certificate
Spécifie le certificat client utilisé pour signer les fichiers de format (*). Fichiers de module format.ps1xml) ou de script (.psm1) dans le module temporaire qui Import-PSSession crée.
Entrez une variable qui contient un certificat, ou bien une commande ou une expression qui obtient le certificat.
Pour rechercher un certificat, utilisez l’applet Get-PfxCertificate de commande ou utilisez l’applet Get-ChildItem de commande dans le lecteur Certificat (Cert :). Si le certificat n'est pas valide ou n'a pas une autorité suffisante, la commande échoue.
| Type: | X509Certificate2 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandName
Spécifie les commandes avec les noms ou modèles de noms spécifiés. Les caractères génériques sont autorisés. Utilisez CommandName ou son alias, Name.
Par défaut, Import-PSSession importe toutes les commandes de la session, à l’exception des commandes qui ont le même nom que les commandes de la session active. Cela empêche les commandes importées de masquer ou de remplacer des commandes dans la session. Pour importer toutes les commandes, même celles qui masquent ou remplacent d’autres commandes, utilisez le paramètre AllowClobber .
Si vous utilisez le paramètre CommandName , les fichiers de mise en forme des commandes ne sont pas importés, sauf si vous utilisez le paramètre FormatTypeName . De même, si vous utilisez le paramètre FormatTypeName , aucune commande n’est importée, sauf si vous utilisez le paramètre CommandName .
| Type: | String[] |
| Aliases: | Name |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandType
Spécifie le type d’objets de commande. La valeur par défaut est Cmdlet. Utilisez CommandType ou son alias, Type. Les valeurs valides pour ce paramètre sont :
Alias: Alias Windows PowerShell dans la session à distance.All: applets de commande et fonctions dans la session à distance.Application: tous les fichiers autres que les fichiers Windows-PowerShell dans les chemins d’accès répertoriés dans la variable d’environnement Path ($env:path) dans la session à distance, y compris les fichiers .txt, .exe et .dll.Cmdlet: applets de commande dans la session à distance. « Cmdlet » est la valeur par défaut.ExternalScript: fichiers .ps1 dans les chemins répertoriés dans la variable d’environnement Path ($env:path) dans la session à distance.FilteretFunction: Les fonctions Windows PowerShell dans la session à distance.Script: blocs de script dans la session à distance.
Ces valeurs sont définies comme une énumération basée sur des indicateurs. Vous pouvez combiner plusieurs valeurs pour définir plusieurs indicateurs à l’aide de ce paramètre. Les valeurs peuvent être passées au paramètre CommandType en tant que tableau de valeurs ou sous forme de chaîne séparées par des virgules de ces valeurs. L’applet de commande combine les valeurs à l’aide d’une opération binary-OR. La transmission de valeurs en tant que tableau est l’option la plus simple et vous permet également d’utiliser la saisie semi-automatique sous forme de tabulation sur les valeurs.
| Type: | CommandTypes |
| Aliases: | Type |
| Accepted values: | Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableNameChecking
Indique que cette applet de commande supprime le message qui vous avertit lorsque vous importez une applet de commande ou une fonction dont le nom inclut un verbe non approuvé ou un caractère interdit.
Par défaut, lorsqu'un module que vous importez exporte des applets de commande ou des fonctions qui ont des verbes non approuvés dans leurs noms, Windows PowerShell affiche le message d'avertissement suivant :
« AVERTISSEMENT : Certains noms de commandes importés incluent des verbes non approuvés qui peuvent les rendre moins détectables. Utilisez le paramètre Verbose pour plus de détails ou de type Get-Verb pour afficher la liste des verbes approuvés. »
Ce message n’est qu’un avertissement. Le module entier est toujours importé, y compris les commandes non conformes. Bien que le message soit affiché aux utilisateurs du module, le problème d'affectation de noms doit être corrigé par l'auteur du module.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FormatTypeName
Spécifie les instructions de mise en forme pour les types Microsoft .NET Framework spécifiés. Entrez les noms des types. Les caractères génériques sont autorisés.
La valeur de ce paramètre doit être le nom d’un type retourné par une Get-FormatData commande dans la session à partir de laquelle les commandes sont importées. Pour obtenir toutes les données de mise en forme dans la session à distance, tapez *.
Si la commande n’inclut pas le paramètre CommandName ou FormatTypeName , Import-PSSession importe les instructions de mise en forme pour tous les types .NET Framework retournés par une Get-FormatData commande dans la session distante.
Si vous utilisez le paramètre FormatTypeName , aucune commande n’est importée, sauf si vous utilisez le paramètre CommandName .
De même, si vous utilisez le paramètre CommandName , les fichiers de mise en forme des commandes ne sont pas importés, sauf si vous utilisez le paramètre FormatTypeName .
| Type: | String[] |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FullyQualifiedModule
La valeur peut être un nom de module, une spécification complète du module ou un chemin d’accès à un fichier de module.
Lorsque la valeur est un chemin d’accès, le chemin d’accès peut être qualifié ou relatif complet. Un chemin relatif est résolu par rapport au script qui contient l’instruction using.
Lorsque la valeur est un nom ou une spécification de module, PowerShell recherche PSModulePath pour le module spécifié.
Une spécification de module est une table de hachage qui a les clés suivantes.
ModuleName- Obligatoire Spécifie le nom du module.GUID- Facultatif Spécifie le GUID du module.- Il est également nécessaire de spécifier au moins l’une des trois clés ci-dessous.
ModuleVersion- Spécifie une version minimale acceptable du module.MaximumVersion- Spécifie la version maximale acceptable du module.RequiredVersion- Spécifie une version exacte et requise du module. Cela ne peut pas être utilisé avec les autres clés de version.
Vous ne pouvez pas spécifier le paramètre FullyQualifiedModule dans la même commande qu’un paramètre module . Les deux paramètres s’excluent mutuellement.
| Type: | ModuleSpecification[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Module
Spécifie et tableau de commandes dans les composants logiciels enfichables et les modules Windows PowerShell. Entrez les noms de composant logiciel enfichable et de module. Les caractères génériques ne sont pas autorisés.
Import-PSSession ne peut pas importer de fournisseurs à partir d’un composant logiciel enfichable.
Pour plus d’informations, consultez about_PSSnapins et about_Modules.
| Type: | String[] |
| Aliases: | PSSnapin |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Prefix
Spécifie un préfixe aux noms des commandes importées.
Utilisez ce paramètre pour éviter les conflits de noms qui peuvent se produire quand des commandes différentes dans la session ont le même nom.
Par exemple, si vous spécifiez le préfixe Remote, puis importez une Get-Date applet de commande, l’applet de commande est connue dans la session Get-RemoteDateet elle n’est pas confondue avec l’applet de commande d’origine Get-Date .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Session
Spécifie la session PSSession à partir de laquelle les applets de commande sont importées. Entrez une variable qui contient un objet de session ou une commande qui obtient un objet de session, tel qu’une ou Get-PSSession une New-PSSession commande. Vous ne pouvez spécifier qu'une seule session. Ce paramètre est obligatoire.
| Type: | PSSession |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
Sorties
Cette applet de commande retourne le même objet de module que celui retourné New-Module par Get-Module les applets de commande.
Toutefois, le module importé est temporaire et existe uniquement dans la session active. Pour créer un module permanent sur le disque, utilisez l’applet de Export-PSSession commande.
Notes
Import-PSSessions’appuie sur l’infrastructure de communication à distance PowerShell. Pour utiliser cette applet de commande, l'ordinateur doit être configuré pour la communication à distance WS-Management. Pour plus d’informations, consultez about_Remote et about_Remote_Requirements.Import-PSSessionn’importe pas de variables ni de fournisseurs PowerShell.- Quand vous importez des commandes qui ont le même nom que les commandes dans la session active, les commandes importées peuvent masquer des alias, des fonctions et des applets de commande dans la session, et peuvent remplacer des fonctions et variables dans la session. Pour éviter les conflits de noms, utilisez le paramètre Préfixe . Pour plus d’informations, consultez about_Command_Precedence.
Import-PSSessionconvertit toutes les commandes en fonctions avant de les importer. Par conséquent, les commandes importées se comportent un peu différemment que si elles avaient conservé leur type de commande d'origine. Par exemple, si vous importez une applet de commande à partir d'une session PSSession, puis une applet de commande avec le même nom à partir d'un module ou d'un composant logiciel enfichable, l'applet de commande qui est importée à partir de la session PSSession s'exécute toujours par défaut, car les fonctions sont prioritaires sur les applets de commande. À l'inverse, si vous importez un alias dans une session qui a un alias avec le même nom, l'alias d'origine est toujours utilisé, car les alias sont prioritaires sur les fonctions. Pour plus d’informations, consultez about_Command_Precedence.Import-PSSessionutilise l’appletWrite-Progressde commande pour afficher la progression de la commande. Vous pouvez voir la barre de progression pendant l'exécution de la commande.- Pour rechercher les commandes à importer,
Import-PSSessionutilise l’appletInvoke-Commandde commande pour exécuter uneGet-Commandcommande dans la session PSSession. Pour obtenir des données de mise en forme pour les commandes, elle utilise l’appletGet-FormatDatade commande. Vous pouvez voir des messages d’erreur à partir de ces applets de commande lorsque vous exécutez uneImport-PSSessioncommande. En outre,Import-PSSessionne peut pas importer de commandes à partir d’une session PSSession qui n’inclut pas les applets de commande ,Get-FormatDataetSelect-ObjectGet-HelplesGet-Commandapplets de commande. - Les commandes importées présentent les mêmes restrictions que d'autres commandes à distance, notamment l'impossibilité de démarrer un programme avec une interface utilisateur, tel que le Bloc-notes.
- Étant donné que les profils Windows PowerShell ne sont pas exécutés dans les sessions PSSession, les commandes qu’un profil ajoute à une session ne sont pas disponibles .
Import-PSSessionPour importer des commandes à partir d’un profil, utilisez uneInvoke-Commandcommande pour exécuter le profil dans la session PSSession manuellement avant d’importer des commandes. - Le module temporaire qui
Import-PSSessioncrée peut inclure un fichier de mise en forme, même si la commande n’importe pas de données de mise en forme. Si la commande n'importe pas de données de mise en forme, les fichiers de mise en forme éventuellement créés ne contiennent pas de données de mise en forme. - Pour utiliser
Import-PSSession, la stratégie d’exécution dans la session active ne peut pas être restreinte ou AllSigned, car le module temporaire quiImport-PSSessioncrée contient des fichiers de script non signés qui sont interdits par ces stratégies. Pour utiliserImport-PSSessionsans modifier la stratégie d’exécution pour l’ordinateur local, utilisez le paramètre Scope deSet-ExecutionPolicyfaçon à définir une stratégie d’exécution moins restrictive pour un seul processus. - Dans Windows PowerShell 2.0, les rubriques d’aide pour les commandes importées à partir d’une autre session n’incluent pas le préfixe que vous affectez à l’aide du paramètre Préfixe . Pour obtenir de l'aide pour une commande importée dans Windows PowerShell 2.0, utilisez le nom de commande (sans préfixe) d'origine.
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour