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 パラメーターの値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。

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

エクスポートされたエイリアス情報を含むファイルのパスを指定します。 ワイルドカードは許可されますが、1 つの名前に解決される必要があります。

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

-Scope

エイリアスのインポート先のスコープを指定します。 このパラメーターの有効値は、次のとおりです。

• グローバル
• ローカル
• スクリプト
• 現在のスコープに対する相対的な数値 (0 からスコープの数、0 が現在のスコープ、1 がその親)

既定値は [ローカル] です。 詳細については、「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

関連リンク

• Export-Alias
• Get-Alias
• New-Alias
• Set-Alias