Import-Alias (Microsoft.PowerShell.Utility)

Import-Alias

Модуль:: Microsoft.PowerShell.Utility

Импортирует список псевдонимов из файла.

Синтаксис

Import-Alias
      [-Path] <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Import-Alias
      -LiteralPath <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Import-Alias импортирует список псевдонимов из файла.

Начиная с Windows PowerShell 3.0, в качестве функции безопасности Import-Alias по умолчанию не перезаписывает существующие псевдонимы. Чтобы перезаписать существующий псевдоним, после проверки безопасности содержимого файла псевдонимов используйте параметр Force.

Примеры

Пример 1. Импорт псевдонимов из файла

Import-Alias test.txt

Эта команда импортирует информацию о псевдониме из файла с именем test.txt.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип :: SwitchParameter
Псевдонимы:: cf
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Force

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

Get-Alias | Select-Object Name, Options

Если соответствующий псевдоним доступен только для чтения, он будет отображаться в значении свойства Options.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-LiteralPath

Указывает путь к файлу, который содержит экспортированную информацию о псевдониме. В отличие от параметра Path, значение параметра LiteralPath используется точно так, как оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки сообщают PowerShell не интерпретировать никакие символы как escape-последовательности.

Тип :: String
Псевдонимы:: PSPath, LP
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-PassThru

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

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Path

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

Тип :: String
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: True

-Scope

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

Глобальный
Местный
Скрипт
Число относительно текущей области (от 0 до количества областей, где 0 — текущая область, а 1 — ее родительский).

По умолчанию установлено локальное. Дополнительные сведения см. в разделе about_Scopes.

Тип :: String
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-WhatIf

Показывает, что произойдет, если командлет запустится. Командлет не запускается.

Тип :: SwitchParameter
Псевдонимы:: wi
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка

Вы можете передать строку, содержащую путь к этому командлету.

Выходы

Нет

По умолчанию этот командлет не возвращает никаких результатов.

Информация об псевдониме

При использовании параметра PassThru этот командлет возвращает объект AliasInfo, представляющий псевдоним.

Примечания

PowerShell включает следующие псевдонимы для Import-Alias:

Все платформы: