官术网_书友最值得收藏!

Recording sessions with transcripts

When working in PowerShell doing various tasks, I find myself doing something that I then want to document or turn into a function and I have to ask myself What did I just do?, Do I know all of the variables I had previously set?, Do I know all the objects I am using?, What kind of authentication am I using?, and so on.

The PowerShell console and ISE have some level of in-built history, but if you're doing large tasks across multiple server environments, this history quickly becomes too small.

Enter PowerShell transcripts. Transcripts are a great way of recording everything you do in a PowerShell session and saving it in a text file for later review.

How to do it...

Carry out the following steps:

  1. Open the PowerShell console (not the ISE) and begin recording a transcript in the default location by executing Start-Transcript.
    How to do it...
  2. Stop the recording by executing Stop-Transcript.
  3. Begin recording a transcript into a different location by calling Start-Transcript with the –Path switch:
    How to do it...

How it works...

In the first step, we execute the command Start-Transcript, which automatically creates transcript under the user's My Documents folder. Each transcript file is named with a unique timestamp that ensures files don't overwrite or conflict with each other. We can stop the recording by then executing Stop-Transcript.

In the third step, we tell PowerShell to save the transcript file to C:\temp\foo.txt. When pointing transcripts to an existing file, PowerShell will attempt to append to the file. If the file is read-only, using the –Force command will instruct PowerShell to attempt to change the permissions on the file, and then append to it.

There's more...

  • Transcript limitations: Session transcripts only work with the PowerShell console, and not the PowerShell ISE. The ISE helps overcome some of this limitation by providing a larger scroll-back area, but if you want to use transcripts, you have to use the console application.
  • Fun with transcripts: Also, because transcripts capture anything typed or written to the screen, you need to be careful what you run. For instance, if you run the following commands, you will result in a recursive loop that has to be manually stopped:
    There's more...

See also

  • See the Creating and using PowerShell profiles recipe for information on how to automatically start transcripts for your sessions.
主站蜘蛛池模板: 中方县| 从化市| 奎屯市| 徐州市| 秀山| 定结县| 津市市| 五常市| 富锦市| 富川| 应城市| 怀化市| 运城市| 翁源县| 松潘县| 永新县| 逊克县| 平远县| 石嘴山市| 闽清县| 遵义县| 平安县| 宁城县| 电白县| 台中县| 青河县| 宁海县| 年辖:市辖区| 宜君县| 敦化市| 枣阳市| 陆丰市| 缙云县| 新巴尔虎左旗| 全南县| 乌拉特中旗| 襄汾县| 哈巴河县| 奎屯市| 寿光市| 麟游县|