Crée un enregistrement de tout ou partie d'une session Windows PowerShell dans un fichier texte.
Syntaxe
Start-Transcript [[-Path] <string>] [-Append] [-Force] [-NoClobber] [-Confirmer] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Start-Transcript crée un enregistrement de tout ou partie d'une session Windows PowerShell dans un fichier texte. La transcription inclut toute commande que l'utilisateur tape et toute sortie qui apparaît sur la console.
Paramètres
-Append
Ajoute la nouvelle transcription à la fin d'un fichier existant. Utilisez le paramètre Path pour spécifier le fichier.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Force
Permet à l'applet de commande d'ajouter la transcription dans un fichier en lecture seule existant. En cas d'utilisation sur un fichier en lecture seule, l'applet de commande transforme l'autorisation d'accès au fichier en lecture/écriture. Même en utilisant le paramètre Force, l'applet de commande ne peut pas remplacer les restrictions de sécurité.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-NoClobber
Ne remplace pas un fichier existant (n'écrase pas son contenu). Par défaut, s'il y a un fichier de transcription dans le chemin d'accès spécifié, Start-Transcript le remplace sans avertissement.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Path <string>
Spécifie un emplacement pour le fichier de transcription. Entrez un chemin d'accès à un fichier .txt. Les caractères génériques ne sont pas autorisés.
Si vous ne spécifiez pas de chemin d'accès, Start-Transcript utilise le chemin d'accès indiqué dans la valeur de la variable globale $Transcript. Si vous n'avez pas créé cette variable, Start-Transcript stocke les transcriptions dans le répertoire $Home\Mes documents en tant que fichiers \PowerShell_transcript.<horodatage>.txt.
Si l'un des répertoires du chemin d'accès n'existe pas, la commande échoue.
|
Obligatoire ? |
false |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirmer
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
None Vous ne pouvez pas diriger des objets vers cette applet de commande. |
|
Sorties |
System.String Start-Transcript retourne une chaîne contenant un message de confirmation et le chemin d'accès au fichier de sortie. |
Remarques
Pour arrêter une transcription, utilisez l'applet de commande Stop-Transcript.
Pour enregistrer une session entière, ajoutez la commande Start-Transcript à votre profil. Pour plus d'informations, consultez about_Profiles.
Exemple 1
C:\PS>start-transcript Description ----------- Cette commande démarre une transcription à l'emplacement par défaut des fichiers.
Exemple 2
C:\PS>start-transcript -path c:\transcripts\transcript0.txt -noclobber Description ----------- Cette commande démarre une transcription dans le fichier Transcript0.txt de C:\transcripts. Le paramètre NoClobber empêche le remplacement des fichiers existants. Si le fichier Transcript0.txt existe déjà, la commande échoue.
Voir aussi