New-Alias
新しいエイリアスを作成します。
構文
Default (既定)
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-Alias コマンドレットは、現在の Windows PowerShell セッションに新しいエイリアスを作成します。 New-Alias を使用して作成されたエイリアスは、セッションを終了した後、または Windows PowerShell を閉じた後は保存されません。 Export-Alias コマンドレットを使用して、エイリアス情報をファイルに保存できます。 後で Import-Alias を使用して、保存したエイリアス情報を取得できます。
例
例 1: コマンドレットのエイリアスを作成する
PS C:\> New-Alias -Name "List" Get-ChildItem
このコマンドは、Get-ChildItem コマンドレットを表す List という名前のエイリアスを作成します。
例 2: コマンドレットの読み取り専用エイリアスを作成する
PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *
このコマンドは、Get-WmiObject コマンドレットを表す W という名前のエイリアスを作成します。 このエイリアスの説明 quick wmi alias を作成し、読み取り専用にします。 コマンドの最後の行では、Get-Alias を使用して新しいエイリアスを取得し、それを Format-List にパイプして、それに関するすべての情報を表示します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Description
エイリアスの説明を指定します。 任意の文字列を入力できます。 説明にスペースが含まれている場合は、引用符で囲みます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
名前付きのエイリアスが既に存在する場合、コマンドレットが Set-Alias のように動作することを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
新しいエイリアスを指定します。 エイリアスには任意の英数字を使用できますが、最初の文字を数字にすることはできません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Option
エイリアスの Options プロパティの値を指定します。 有効な値は次のとおりです。
- なし: エイリアスには制約がありません (デフォルト値)
- ReadOnly: エイリアスは削除できますが、 Force パラメーターを使用しない場合以外は変更できません
- 定数: エイリアスは削除または変更できません
- プライベート: エイリアスは現在のスコープでのみ使用できます
- AllScope: エイリアスは、作成された新しいスコープにコピーされます
- 未指定: オプションは指定されていません
セッション内のすべてのエイリアスの Options プロパティを表示するには、「Get-Alias | Format-Table -Property Name, Options -AutoSize」と入力します。
パラメーターのプロパティ
| 型: | ScopedItemOptions |
| 規定値: | [System.Management.Automation.ScopedItemOptions]::None |
| 指定可能な値: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PassThru
作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Scope
新しいエイリアスのスコープを指定します。 このパラメーターに使用できる値は次のとおりです。
- グローバル
- ローカル
- スクリプト
- 現在のスコープに対する相対的な数値 (0 からスコープの数、0 が現在のスコープ、1 がその親)。
既定値は Local です。 詳細については、「about_Scopes」を参照してください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Value
エイリアス化されるコマンドレットまたはコマンド要素の名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
None
パイプを使用してこのコマンドレットに入力を渡すことはできません。
出力
None or System.Management.Automation.AliasInfo
Passthru パラメータを使用すると、New-Alias は新しいエイリアスを表す System.Management.Automation.AliasInfo オブジェクトを生成します。 それ以外の場合、このコマンドレットは出力を生成しません。
メモ
新しいエイリアスを作成するには、Set-Alias または New-Alias を使用します。 エイリアスを変更するには、 Set-Alias を使用します。 エイリアスを削除するには、Remove-Item を使用します。