Создает запись всего сеанса Windows PowerShell или его части в текстовом файле.
Синтаксис
Start-Transcript [[-Path] <string>] [-Append] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет Start-Transcript создает запись всего сеанса Windows PowerShell или его части в текстовом файле. Запись включает все команды, вводимые пользователем, и все выходные данные, которые отображаются на консоли.
Параметры
-Append
Добавляет новый протокол в конец существующего файла. Используйте параметр Path, чтобы указать файл.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Force
Позволяет командлету добавлять записи в существующий файл, доступный только для чтения. При использовании с файлом, доступным только для чтения, командлет изменяет разрешения доступа к файлу на "чтение-запись". Даже при использовании параметра Force командлет не может переопределить ограничения безопасности.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-NoClobber
Не будет перезаписывать существующий файл (то есть заменять его содержимое). По умолчанию если по указанному пути существует файл протокола, командлет Start-Transcript перезаписывает файл без предупреждения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Path <string>
Задает местонахождение файла протокола. Введите путь для TXT-файла. Подстановочные знаки запрещены.
Если путь не указан, командлет Start-Transcript использует путь в значении глобальной переменной $Transcript. Если эта переменная не создана, командлет Start-Transcript сохраняет протоколы в каталоге "$Home\Мои документы" в файлах "\PowerShell_transcript.<метка-времени>.txt".
Если какой-нибудь из каталогов в пути не существует, то выполнение команды завершается ошибкой.
|
Обязательно? |
false |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
None Передать объекты этому командлету по конвейеру невозможно. |
|
Выходные данные |
System.String Start-Transcript возвращает строку, содержащую подтверждающее сообщение и путь к выходному файлу. |
Примечания
Чтобы остановить запись, используйте командлет Stop-Transcript.
Чтобы записать весь сеанс, добавьте команду Start-Transcript в свой профиль. Дополнительные сведения см. в разделе about_Profiles.
Пример 1
C:\PS>start-transcript Описание ----------- Эта команда запускает запись в файл с местоположением по умолчанию.
Пример 2
C:\PS>start-transcript -path c:\transcripts\transcript0.txt -noclobber Описание ----------- Эта команда запускает запись в файл Transcript0.txt в каталоге "C:\transcripts". Параметр NoClobber запрещает перезаписывать любые существующие файлы. Если файл Transcript0.txt уже существует, то выполнение команды завершается неудачей.
См. также