Import-Alias
ファイルからエイリアス一覧をインポートします。
構文
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 |
入力
へのパス Import-Alias
を含む文字列をパイプ処理できます。
出力
None or System.Management.Automation.AliasInfo
Passthru パラメーターを使用すると、Import-Alias
エイリアスを表す System.Management.Automation.AliasInfo オブジェクトが返されます。
それ以外の場合、このコマンドレットによる出力はありません。