Bagikan melalui

New-Alias

Modul:
Microsoft.PowerShell.Utility Module

Membuat alias baru.

Sintaks

Default (Default) 

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

Deskripsi

cmdlet New-Alias membuat alias baru dalam sesi PowerShell saat ini. Alias yang dibuat dengan menggunakan New-Alias tidak disimpan setelah Anda keluar dari sesi atau menutup PowerShell. Anda dapat menggunakan cmdlet Export-Alias 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 cmdlet Get-ChildItem. 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 ke 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 fungsi Set-ParentDirectory. 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 konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Description

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

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

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

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa: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 Force
  • Constant: Alias tidak dapat dihapus atau diubah
  • Private: Alias hanya tersedia dalam cakupan saat ini
  • AllScope: Alias disalin ke semua cakupan baru 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 .

Properti parameter

Jenis:ScopedItemOptions
Nilai default:[System.Management.Automation.ScopedItemOptions]::None
Nilai yang diterima:None, ReadOnly, Constant, Private, AllScope, Unspecified
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-PassThru

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Scope

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

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

Local adalah default. Untuk informasi selengkapnya, lihat about_Scopes.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Value

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

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:1
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

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.