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

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
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

Можно передать строку, содержащую путь к Import-Alias.

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

None or System.Management.Automation.AliasInfo

При использовании параметра PassthruImport-Alias возвращается объект System.Management.Automation.AliasInfo, представляющий псевдоним. В противном случае этот командлет не создает выходные данные.