Export-Console

  • Référence
Module:
Microsoft.PowerShell.Core

Exporte les noms des composants logiciels enfichables de la session active dans un fichier de console.

Syntax

Export-Console
      [[-Path] <String>]
      [-Force]
      [-NoClobber]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet Export-Console de commande exporte les noms des composants logiciels enfichables Windows PowerShell dans la session active vers un fichier de console Windows PowerShell (.psc1). Vous pouvez utiliser cette applet de commande pour enregistrer les composants logiciels enfichables à utiliser plus tard dans d'autres sessions.

Pour ajouter les composants logiciels enfichables dans le fichier console .psc1 à une session, démarrez Windows PowerShell (PowerShell.exe) sur la ligne de commande à l’aide de Cmd.exe ou d’une autre session Windows PowerShell, puis utilisez le paramètre PSConsoleFile de PowerShell.exe pour spécifier le fichier console.

Pour plus d’informations sur les composants logiciels enfichables Windows PowerShell, consultez about_PSSnapins.

Exemples

Exemple 1 : Exporter les noms des composants logiciels enfichables dans la session active

PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1

Cette commande exporte les noms des composants logiciels enfichables Windows PowerShell dans la session active vers le fichier dans le ConsoleS1.psc1 dossier Consoles du dossier d’installation De Windows PowerShell. $pshome

Exemple 2 : Exporter les noms des composants logiciels enfichables dans le fichier console le plus récent

Export-Console

Cette commande exporte les noms des composants logiciels enfichables Windows PowerShell de la session active dans le dernier fichier de console Windows PowerShell utilisé dans la session active. Elle remplace le contenu précédent du fichier.

Si vous n'avez pas exporté de fichier de console pendant la session active, vous êtes invité à autoriser la poursuite de l'opération et à entrer un nom de fichier.

Exemple 3 : Ajouter un composant logiciel enfichable et exporter les noms des composants logiciels enfichables

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

Ces commandes ajoutent le composant logiciel enfichable NewPSSnapin Windows PowerShell à la session active, exportez les noms des composants logiciels enfichables Windows PowerShell dans la session active vers un fichier console, puis démarrez une session Windows PowerShell avec le fichier console.

La première commande utilise l’applet Add-PSSnapin de commande pour ajouter le composant logiciel enfichable NewPSSnapin à la session active. Vous ne pouvez ajouter que les composants logiciels enfichables Windows PowerShell inscrits sur votre système.

La deuxième commande exporte les noms de composants logiciels enfichables Windows PowerShell vers le NewPSSnapinConsole.psc1 fichier.

La troisième commande démarre Windows PowerShell avec le NewPSSnapinConsole.psc1 fichier. Étant donné que le fichier de console inclut le nom du composant logiciel enfichable Windows PowerShell, les applets de commande et les fournisseurs du composant logiciel enfichable sont disponibles dans la session active.

Exemple 4 : Exporter des noms de composants logiciels enfichables vers un emplacement spécifié

PS C:\> export-console -path Console01
PS C:\> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
  <PSVersion>2.0</PSVersion>
  <PSSnapIns>
     <PSSnapIn Name="NewPSSnapin" />
  </PSSnapIns>
</PSConsoleFile>

Cette commande exporte les noms des composants logiciels enfichables Windows PowerShell dans la session active vers le Console01.psc1 fichier du répertoire actif.

La deuxième commande affiche le contenu du Console01.psc1 fichier dans Bloc-notes Windows.

Exemple 5 : Déterminer le fichier console à mettre à jour

powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-Console

Cet exemple montre comment utiliser la $ConsoleFileName variable automatique pour déterminer le fichier console qui sera mis à jour si vous utilisez Export-Console sans valeur de paramètre Path .

La première commande utilise le paramètre PSConsoleFile de PowerShell.exe pour ouvrir Windows PowerShell avec le Console01.psc1 fichier.

La deuxième commande utilise l’applet Add-PSSnapin de commande pour ajouter le composant logiciel enfichable Windows PowerShell MySnapin à la session active.

La troisième commande utilise l’applet Export-Console de commande pour exporter les noms de tous les composants logiciels enfichables Windows PowerShell dans la session vers le NewConsole.psc1 fichier.

La quatrième commande affiche la $ConsoleFileName variable. Il contient le fichier console le plus récemment utilisé. L'exemple de sortie montre que NewConsole.ps1 est le dernier fichier utilisé.

La cinquième commande ajoute SnapIn03 à la console actuelle.

La sixième commande utilise l’applet Export-Console de commande sans paramètre Path . Cette commande exporte les noms de tous les composants logiciels enfichables Windows PowerShell dans la session active vers le fichier le plus récemment utilisé. NewConsole.psc1

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Force

Indique que cette applet de commande remplace les données d’un fichier console sans avertissement, même si le fichier a l’attribut en lecture seule. L’attribut en lecture seule est modifié et n’est pas réinitialisé lorsque la commande se termine.

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

-NoClobber

Indique que cette applet de commande ne remplace pas un fichier de console existant. Par défaut, si un fichier se produit dans le chemin d’accès spécifié, Export-Console remplace le fichier sans avertissement.

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

-Path

Spécifie un chemin d’accès et un nom de fichier pour le fichier console (*.psc1). Entrez un chemin et un nom facultatifs. Les caractères génériques ne sont pas autorisés.

Si vous spécifiez uniquement un nom de fichier, Export-Console crée un fichier portant ce nom et l’extension de nom de fichier .psc1 dans le répertoire actif.

Ce paramètre est requis, sauf si vous avez ouvert Windows PowerShell avec le paramètre PSConsoleFile ou exporté un fichier console pendant la session active. Il est également nécessaire lorsque vous utilisez le paramètre NoClobber pour empêcher le remplacement du fichier console actuel.

Si vous omettez ce paramètre, Export-Console remplace le fichier console utilisé le plus récemment dans cette session. Le chemin d’accès du fichier console le plus récemment utilisé est stocké dans la valeur de la variable automatique $ConsoleFileName. Pour plus d’informations, consultez about_Automatic_Variables.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

String

Vous pouvez diriger une chaîne de chemin vers cette applet de commande.

Sorties

FileInfo

Cette applet de commande crée un fichier qui contient les alias exportés.

Notes

  • Lorsqu’un fichier de console (.psc1) est utilisé pour démarrer la session, le nom du fichier console est automatiquement stocké dans la $ConsoleFileName variable automatique. La valeur de $ConsoleFileName cette propriété est mise à jour lorsque vous utilisez le paramètre Path pour Export-Console spécifier un nouveau fichier de console. Lorsqu’aucun fichier de console n’est utilisé, $ConsoleFileName n’a aucune valeur ($null).

    Pour utiliser un fichier de console Windows PowerShell dans une nouvelle session, employez la syntaxe suivante pour démarrer Windows PowerShell :

    powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1

    Vous pouvez également enregistrer les composants logiciels enfichables Windows PowerShell pour des sessions futures en ajoutant une commande Add-PSSnapin à votre profil Windows PowerShell. Pour plus d’informations, consultez about_Profiles.