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