about_Profiles

  • Статья

Краткое описание

Описывает создание и использование профиля PowerShell.

Подробное описание

Вы можете создать профиль PowerShell для настройки среды и добавить элементы, относящиеся к сеансу, в каждый сеанс PowerShell, который вы запускаете.

Профиль PowerShell — это скрипт, выполняющийся при запуске PowerShell. Профиль можно использовать в качестве скрипта запуска для настройки среды. Вы можете добавлять команды, псевдонимы, функции, переменные, модули, диски PowerShell и многое другое. Вы также можете добавить в профиль другие элементы, относящиеся к сеансу, чтобы они были доступны в каждом сеансе без необходимости их импорта или повторного создания.

PowerShell поддерживает несколько профилей для пользователей и ведущих программ. Однако он не создает профили для вас.

Типы и расположения профилей

PowerShell поддерживает несколько файлов профилей, которые относятся к пользователям и узлам PowerShell. На компьютере можно использовать любой или все эти профили.

Например, консоль PowerShell поддерживает следующие базовые файлы профилей. Профили перечислены в порядке их выполнения.

  • Все пользователи, все узлы
    • Для Windows — $PSHOME\Profile.ps1.
    • Linux — /usr/local/microsoft/powershell/7/profile.ps1.
    • Macos- /usr/local/microsoft/powershell/7/profile.ps1
  • Все пользователи, текущий узел
    • Для Windows — $PSHOME\Microsoft.PowerShell_profile.ps1.
    • Linux — /usr/local/microsoft/powershell/7/Microsoft.Powershell_profile.ps1.
    • Macos- /usr/local/microsoft/powershell/7/Microsoft.Powershell_profile.ps1
  • Текущий пользователь, все узлы
    • Для Windows — $HOME\Documents\PowerShell\Profile.ps1.
    • Linux — ~/.config/powershell/profile.ps1.
    • Macos- ~/.config/powershell/profile.ps1
  • Текущий пользователь, текущий узел
    • Для Windows — $HOME\Documents\PowerShell\Microsoft.PowerShell_profile.ps1.
    • Linux — ~/.config/powershell/Microsoft.Powershell_profile.ps1.
    • Macos- ~/.config/powershell/Microsoft.Powershell_profile.ps1

Скрипты профилей выполняются в указанном порядке. Это означает, что изменения, внесенные в профиль AllUsersAllHosts , могут быть переопределены любым другим скриптом профиля. Профиль CurrentUserCurrentHost всегда выполняется последним. В справке PowerShell профиль CurrentUserCurrentHost чаще всего называется профилем PowerShell.

Другие программы, в которых размещается PowerShell, могут поддерживать собственные профили. Например, Visual Studio Code (VS Code) поддерживает следующие профили узла.

  • Все пользователи, текущий узел — $PSHOME\Microsoft.VSCode_profile.ps1
  • Текущий пользователь, текущий узел — $HOME\Documents\PowerShell\Microsoft.VSCode_profile.ps1

Пути к профилю включают следующие переменные:

  • Переменная $PSHOME хранит каталог установки для PowerShell.
  • Переменная $HOME хранит домашний каталог текущего пользователя.

Примечание

В Windows расположение папки "Документы" можно изменить с помощью перенаправления папок или OneDrive. Не рекомендуется перенаправлять папку "Документы" в сетевую папку или включать ее в OneDrive. Перенаправление папки может привести к сбою загрузки модулей и возникновению ошибок в сценариях профиля.

Переменная $PROFILE

Автоматическая переменная $PROFILE содержит пути к профилям PowerShell, доступным в текущем сеансе.

Чтобы просмотреть путь к профилю, отобразите значение переменной $PROFILE . Вы также можете использовать $PROFILE переменную в команде для представления пути.

Переменная $PROFILE сохраняет путь к профилю "Текущий пользователь, текущий узел". Другие профили сохраняются в свойствах заметок переменной $PROFILE .

Например, $PROFILE переменная имеет следующие значения в консоли Windows PowerShell.

  • Текущий пользователь, текущий узел — $PROFILE
  • Текущий пользователь, текущий узел — $PROFILE.CurrentUserCurrentHost
  • Текущий пользователь, все узлы — $PROFILE.CurrentUserAllHosts
  • Все пользователи, текущий узел — $PROFILE.AllUsersCurrentHost
  • Все пользователи, все узлы — $PROFILE.AllUsersAllHosts

Так как значения переменной $PROFILE изменяются для каждого пользователя и в каждом ведущем приложении, убедитесь, что значения переменных профиля отображаются в каждом используемом ведущем приложении PowerShell.

Чтобы просмотреть текущие значения переменной, введите $PROFILE :

$PROFILE | Get-Member -Type NoteProperty

Переменную можно использовать $PROFILE во многих командах. Например, следующая команда открывает профиль "Текущий пользователь, текущий узел" в Блокноте:

notepad $PROFILE

Следующая команда определяет, был ли создан профиль "Все пользователи, все узлы" на локальном компьютере:

Test-Path -Path $PROFILE.AllUsersAllHosts

Создание профиля

Чтобы создать профиль PowerShell, используйте следующий формат команды:

if (!(Test-Path -Path <profile-name>)) {
  New-Item -ItemType File -Path <profile-name> -Force
}

Например, чтобы создать профиль для текущего пользователя в текущем ведущем приложении PowerShell, используйте следующую команду:

if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}

В этой команде if инструкция запрещает перезапись существующего профиля. Замените значение переменной $PROFILE путем к файлу профиля, который требуется создать.

Примечание

Чтобы создать профили "Все пользователи" в Windows Vista и более поздних версиях Windows, запустите PowerShell с параметром Запуск от имени администратора .

Изменение профиля

В текстовом редакторе можно открыть любой профиль PowerShell, например Блокнот.

Чтобы открыть профиль текущего пользователя в текущем ведущем приложении PowerShell в Блокноте, введите:

notepad $PROFILE

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

notepad $PROFILE.AllUsersAllHosts

Чтобы применить изменения, сохраните файл профиля и перезапустите PowerShell.

Выбор профиля

Если вы используете несколько ведущих приложений, поместите элементы, используемые во всех ведущих приложениях, в свой $PROFILE.CurrentUserAllHosts профиль. Поместите элементы, относящиеся к ведущему приложению, например команду, которая задает цвет фона для ведущего приложения, в профиль, относящийся к ведущему приложению.

Если вы являетесь администратором, который настраивает PowerShell для многих пользователей, следуйте приведенным ниже рекомендациям.

  • Сохранение общих элементов в $PROFILE.AllUsersAllHosts профиле
  • Хранение элементов, относящихся к ведущему приложению, в $PROFILE.AllUsersCurrentHost профилях, относящихся к ведущему приложению
  • Хранение элементов для определенных пользователей в профилях пользователей

Не забудьте проверка документацию по ведущему приложению для любой специальной реализации профилей PowerShell.

Использование профиля

Многие элементы, создаваемые в PowerShell, и большинство выполняемых команд влияют только на текущий сеанс. После завершения сеанса элементы удаляются.

К командам и элементам сеанса относятся переменные PowerShell, переменные среды, псевдонимы, функции, команды и модули PowerShell, добавляемые в сеанс.

Чтобы сохранить эти элементы и сделать их доступными во всех будущих сеансах, добавьте их в профиль PowerShell.

Еще одним распространенным способом использования профилей является сохранение часто используемых функций, псевдонимов и переменных. При сохранении элементов в профиле их можно использовать в любом применимом сеансе, не создавая их повторно.

Создание профиля

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

Ниже приведено несколько рекомендаций по началу работы.

Добавьте функцию, которая перечисляет псевдонимы для любого командлета.

function Get-CmdletAlias ($cmdletname) {
  Get-Alias |
    Where-Object -FilterScript {$_.Definition -like "$cmdletname"} |
      Format-Table -Property Definition, Name -AutoSize
}

Настройка консоли

function CustomizeConsole {
  $hosttime = (Get-ChildItem -Path $PSHOME\pwsh.exe).CreationTime
  $hostversion="$($Host.Version.Major)`.$($Host.Version.Minor)"
  $Host.UI.RawUI.WindowTitle = "PowerShell $hostversion ($hosttime)"
  Clear-Host
}
CustomizeConsole

Добавление настраиваемой командной строки PowerShell

function Prompt
{
$env:COMPUTERNAME + "\" + (Get-Location) + "> "
}

Дополнительные сведения о командной строке PowerShell см. в разделе about_Prompts.

Другие примеры профиля см. в разделе Настройка среды оболочки.

Параметр NoProfile

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

Для начала откройте программу, которая может запустить PowerShell, например Cmd.exe или powerShell. Вы также можете использовать диалоговое окно Запуск в Windows.

Тип:

pwsh -NoProfile

Чтобы получить полный список параметров , введите pwsh.exe:

pwsh -?

Профили и политика выполнения

Политика выполнения PowerShell частично определяет, можно ли запускать скрипты и загружать файлы конфигурации, включая профили. По умолчанию используется политика ограниченного выполнения. Это предотвращает выполнение всех скриптов, включая профили. Если вы используете политику Restricted, профиль не запускается, и его содержимое не применяется.

Команда Set-ExecutionPolicy задает и изменяет политику выполнения. Это одна из немногих команд, которая применяется во всех сеансах PowerShell, так как значение сохраняется в реестре. Вам не нужно настраивать его при открытии консоли и не нужно сохранять Set-ExecutionPolicy команду в своем профиле.

Профили и удаленные сеансы

Профили PowerShell не запускаются автоматически в удаленных сеансах, поэтому команды, добавляемые профилями, не присутствуют в удаленном сеансе. Кроме того, $PROFILE автоматическая переменная не заполняется в удаленных сеансах.

Чтобы запустить профиль в сеансе, используйте командлет Invoke-Command .

Например, следующая команда запускает профиль "Текущий пользователь, текущий узел" с локального компьютера в сеансе в $s.

Invoke-Command -Session $s -FilePath $PROFILE

Следующая команда запускает профиль "Текущий пользователь, текущий узел" с удаленного компьютера в сеансе в $s. $PROFILE Так как переменная не заполнена, команда использует явный путь к профилю. Мы используем оператор точечного источников, чтобы профиль выполнялся в текущем область на удаленном компьютере, а не в его собственной область.

Invoke-Command -Session $s -ScriptBlock {
  . "$HOME\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1"
}

После выполнения этой команды команды, которые профиль добавляет в сеанс, доступны в $s.

См. также раздел