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

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

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

None or System.Management.Automation.AliasInfo

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