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

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

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Get-Alias | Select-Object Name, Options

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

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

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Scope

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

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

String

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

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

None

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

AliasInfo

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

Примечания

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

  • Для всех платформ.
    • ipal