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 List 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 menciptakan 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-List untuk menampilkan semua informasi tentangnya.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value: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
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
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
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 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.

Type:ScopedItemOptions
Accepted values:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
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 dan 1 merupakan induknya).

Local adalah default. Untuk informasi selengkapnya, lihat about_Scopes.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Value

Menentukan nama cmdlet atau elemen perintah yang sedang dialirkan.

Type:String
Position:1
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Anda tidak dapat menyalurkan input ke cmdlet ini.

Output

None or System.Management.Automation.AliasInfo

Saat Anda menggunakan parameter Passthru , New-Alias menghasilkan objek System.Management.Automation.AliasInfo yang mewakili alias baru. Jika tidak, cmdlet ini tidak menghasilkan output apa pun.

Catatan

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