New-Alias
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
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
Perintah ini membuat alias bernama C
untuk mewakili Get-ChildItem
cmdlet. Ini membuat deskripsi, alias wmi cepat, untuk alias dan membuatnya baca-saja. Baris terakhir dari perintah menggunakan Get-Alias
untuk mendapatkan alias baru dan menyalurkannya ke Format-Daftar untuk menampilkan semua informasi tentangnya.
Parameter
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Menentukan deskripsi alias. Anda dapat mengetik string apa pun. Jika deskripsi menyertakan spasi, sertakan dalam tanda kutip.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Menunjukkan bahwa cmdlet bertindak seperti Set-Alias
jika alias bernama sudah ada.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Menentukan alias baru. Anda dapat menggunakan karakter alfanumerik apa pun dalam alias, tetapi karakter pertama tidak boleh berupa angka.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 PaksaConstant
: Alias tidak dapat dihapus atau diubahPrivate
: Alias hanya tersedia dalam cakupan saat iniAllScope
: Alias disalin ke cakupan baru apa pun yang dibuatUnspecified
: 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
.
Type: | ScopedItemOptions |
Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | [System.Management.Automation.ScopedItemOptions]::None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 dan1
merupakan induknya).
Local
adalah defaultnya. Untuk informasi selengkapnya, lihat about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Menentukan nama cmdlet atau elemen perintah yang sedang di-alias.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
None
Secara default, cmdlet ini tidak mengembalikan output.
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
atauNew-Alias
. Untuk mengubah alias, gunakanSet-Alias
. Untuk menghapus alias, gunakanRemove-Alias
.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk