Поделиться через

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
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

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

Get-Alias | Select-Object Name, Options

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LiteralPath

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

Тип:String
Aliases:PSPath, LP
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PassThru

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

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

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Scope

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

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

Значение по умолчанию — Local. Дополнительные сведения см. в about_Scopes.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

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

Выходные данные

None

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

AliasInfo

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

Примечания

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

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