Bagikan melalui

New-Alias

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Membuat alias baru.

Sintaks

New-Alias
   [-Name] <String>
   [-Value] <String>
   [-Description <String>]
   [-Option <ScopedItemOptions>]
   [-PassThru]
   [-Scope <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

New-Alias Cmdlet membuat alias baru di sesi PowerShell saat ini. Alias yang dibuat dengan menggunakan New-Alias tidak disimpan setelah Anda keluar dari sesi atau menutup PowerShell. Anda dapat menggunakan Export-Alias cmdlet untuk menyimpan informasi alias Anda ke file. Anda nantinya dapat menggunakan Import-Alias untuk mengambil informasi alias yang disimpan.

Contoh

Contoh 1: Membuat alias untuk cmdlet

New-Alias -Name "List" Get-ChildItem

Perintah ini membuat alias bernama Daftar untuk mewakili cmdlet Get-ChildItem.

Contoh 2: Membuat alias baca-saja untuk cmdlet

Perintah ini membuat alias bernama C untuk mewakili Get-ChildItem cmdlet. Ini membuat deskripsi "alias gci cepat" untuk alias dan membuatnya baca-saja.

New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

Perintah Get-Alias yang disalurkan untuk Format-List menunjukkan semua informasi tentang alias baru.

Contoh 3: Membuat alias untuk perintah dengan parameter

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

Perintah pertama membuat fungsi Set-ParentDirectory, yang menggunakan Set-Location untuk mengatur lokasi kerja ke direktori induk. Perintah kedua menggunakan New-Alias untuk membuat alias .. untuk memanggil Set-ParentDirectory fungsi. Karena parameter Nilai memerlukan cmdlet, fungsi, atau nilai yang dapat dieksekusi, Anda harus membuat fungsi kustom untuk membuat alias yang menggunakan parameter. Menjalankan alias .. mengubah lokasi saat ini ke direktori induk.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Description

Menentukan deskripsi alias. Anda dapat mengetik string apa pun. Jika deskripsi menyertakan spasi, sertakan dalam tanda kutip.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Force

Menunjukkan bahwa cmdlet bertindak seperti Set-Alias jika alias bernama sudah ada.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Name

Menentukan alias baru. Anda dapat menggunakan karakter alfanumerik apa pun dalam alias, tetapi karakter pertama tidak boleh berupa angka.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Option

Menentukan nilai properti Opsi alias. Nilai yang valid adalah:

  • None: Alias tidak memiliki batasan (nilai default)
  • ReadOnly: Alias dapat dihapus tetapi tidak dapat diubah kecuali dengan menggunakan parameter Paksa
  • Constant: Alias tidak dapat dihapus atau diubah
  • Private: Alias hanya tersedia dalam cakupan saat ini
  • AllScope: Alias disalin ke cakupan baru apa pun yang dibuat
  • Unspecified: Opsi tidak ditentukan

Nilai-nilai ini didefinisikan sebagai enumerasi berbasis bendera. Anda dapat menggabungkan beberapa nilai bersama-sama untuk mengatur beberapa bendera menggunakan parameter ini. Nilai dapat diteruskan ke parameter Opsi sebagai array nilai atau sebagai string yang dipisahkan koma dari nilai tersebut. Cmdlet akan menggabungkan nilai menggunakan operasi biner-OR. Meneruskan nilai sebagai array adalah opsi paling sederhana dan juga memungkinkan Anda menggunakan penyelesaian tab pada nilai.

Untuk melihat properti Opsi dari semua alias dalam sesi, ketik Get-Alias | Format-Table -Property Name, Options -AutoSize.

Jenis:ScopedItemOptions
Nilai yang diterima:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Nilai default:[System.Management.Automation.ScopedItemOptions]::None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PassThru

Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Scope

Menentukan cakupan alias baru. Nilai yang dapat diterima untuk parameter ini adalah:

  • Global
  • Local
  • Script
  • Angka relatif terhadap cakupan saat ini (0 melalui jumlah cakupan, di mana 0 adalah cakupan saat ini dan 1 merupakan induknya).

Local adalah defaultnya. Untuk informasi selengkapnya, lihat about_Scopes.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Value

Menentukan nama cmdlet atau elemen perintah yang sedang di-alias.

Jenis:String
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

AliasInfo

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek AliasInfo yang mewakili alias baru.

Catatan

PowerShell menyertakan alias berikut untuk New-Alias:

  • Semua platform:

    • nal

  • Untuk membuat alias baru, gunakan Set-Alias atau New-Alias. Untuk mengubah alias, gunakan Set-Alias. Untuk menghapus alias, gunakan Remove-Alias.