PowerShell: Документирование вашей работы с помощью Start-Transcript

Start-Transcript создает запись сессий PowerShell. Для документирования и архивирования. Эта функция очень полезна для административных задач и программирования. В этой статье описывается использование Start-Transcript и Stop-Transcript на локальном хосте и в удаленных сессиях.

Просто введите start-transcript, и ваша сессия будет записана в вашей домашней папке. Созданный текстовый файл включает дату записи и имя вашего хоста.

Start-Transcript

Start-Transcript

Чтобы указать другое местоположение и имя файла, укажите параметр пути.

Start-Transcript -Path c:\Temp\Log1.txt

NoClobber

Start-Transcript перезаписывает файлы без предупреждения. Обходным решением является параметр NoClobber.

Start-Transcript -NoClobber -Path C:\Temp\Log1.txt

Добавить

Параметр Append добавляет новый транскрипт в конец существующего файла.

Start-Transcript -Append C:\Temp\Log1.txt

Stop-Transcript

После выхода из PowerShell запись останавливается. Вы можете остановить запись вручную, запустив команду Stop-Transcript.

Stop-Transcript

Запустить транскрипцию на удаленных хостах

В удаленной сессии PowerShell вы можете начать запись на удаленном хосте. Файл сохраняется на удаленном компьютере. Я вошел на Server03. Я начинаю сессию PowerShell на DC01 и запускаю Start-Transcript. Смотрите, что происходит:

Enter-PSSession -ComputerName dc01
Start-Transcript

Для получения дополнительной информации о удаленных сеансах PowerShell смотрите мою статью   Как настроить доверенные хосты для удаленных сеансов PowerShell.

Как выглядит файл?

Что ж, файл не выиграет награду за красоту. Но вся важная информация и команды вашей сессии PowerShell сохранены и задокументированы.

Автоматическая запись

Чтобы начать запись каждый раз, когда вы запускаете PowerShell, просто измените свой профиль PowerShell. Чтобы создать профиль, введите

New-Item -Path $Profile -Force

Затем добавьте Start-Transcript в ваш профиль.

Add-Content -Path $Profile -Value "Start-Transcript"

Запись начнется автоматически. Закройте PowerShell и откройте его снова. Вы должны увидеть следующее:

Дальнейшие размышления

Включите Start-Transcript в ваш профиль PowerShell: Как создать профили PowerShell или настроить ведение журнала для каждого модуля отдельно: Мониторинг Windows PowerShell: Включите ведение журнала модулей