New-Alias

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Yeni bir diğer ad oluşturur.

Syntax

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

Description

Cmdlet, New-Alias geçerli PowerShell oturumunda yeni bir diğer ad oluşturur. kullanarak New-Alias oluşturulan diğer adlar, oturumdan çıktıktan veya PowerShell'i kapattıktan sonra kaydedilmez. Diğer ad bilgilerinizi bir dosyaya kaydetmek için cmdlet'ini kullanabilirsiniz Export-Alias . Daha sonra bu kaydedilen diğer ad bilgilerini almak için kullanabilirsiniz Import-Alias .

Örnekler

Örnek 1: Cmdlet için diğer ad oluşturma

New-Alias -Name "List" Get-ChildItem

Bu komut, Get-ChildItem cmdlet'ini temsil etmek için List adlı bir diğer ad oluşturur.

Örnek 2: Cmdlet için salt okunur diğer ad oluşturma

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

Bu komut, cmdlet'ini Get-ChildItem temsil etmek için adlı C bir diğer ad oluşturur. Diğer ad için hızlı wmi diğer adı olan bir açıklama oluşturur ve bunu salt okunur hale getirir. Komutun son satırı, yeni diğer adı almak için kullanır Get-Alias ve bu diğer adı Biçim Listesi'ne arayarak bu diğer adla ilgili tüm bilgileri görüntüler.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Diğer adın açıklamasını belirtir. Herhangi bir dize yazabilirsiniz. Açıklama boşluk içeriyorsa, tırnak içine alın.

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

-Force

Cmdlet'in adlı diğer adın zaten mevcut olması gibi Set-Alias davrandığını gösterir.

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

-Name

Yeni diğer adı belirtir. Diğer addaki alfasayısal karakterleri kullanabilirsiniz, ancak ilk karakter sayı olamaz.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Option

Diğer adın Options özelliğinin değerini belirtir. Geçerli değerler:

  • None: Diğer adın kısıtlaması yok (varsayılan değer)
  • ReadOnly: Diğer ad silinebilir, ancak Force parametresinin kullanılması dışında değiştirilemez
  • Constant: Diğer ad silinemez veya değiştirilemez
  • Private: Diğer ad yalnızca geçerli kapsamda kullanılabilir
  • AllScope: Diğer ad, oluşturulan tüm yeni kapsamlara kopyalanır
  • Unspecified: Seçenek belirtilmemiş

Bu değerler, bayrak tabanlı bir numaralandırma olarak tanımlanır. Bu parametreyi kullanarak birden çok bayrak ayarlamak için birden çok değeri birlikte birleştirebilirsiniz. Değerler Option parametresine bir değer dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak geçirilebilir. cmdlet'i bir ikili OR işlemi kullanarak değerleri birleştirir. Değerleri dizi olarak geçirmek en basit seçenektir ve değerler üzerinde sekme tamamlama özelliğini kullanmanıza da olanak tanır.

Oturumdaki tüm diğer adların Options özelliğini görmek için yazın 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

Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

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

-Scope

Yeni diğer adın kapsamını belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Global
  • Local
  • Script
  • Geçerli kapsama göre bir sayı (0, 0 geçerli kapsam ve 1 onun üst kapsamı olan kapsam sayısı üzerinden).

Local varsayılan değerdir. Daha fazla bilgi için bkz . about_Scopes.

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

-Value

Diğer adlandırılan cmdlet'in veya komut öğesinin adını belirtir.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

AliasInfo

PassThru parametresini kullandığınızda, bu cmdlet yeni diğer adı temsil eden bir AliasInfo nesnesi döndürür.

Notlar

PowerShell için aşağıdaki diğer adları New-Aliasiçerir:

  • Tüm platformlar:

    • nal

  • Yeni bir diğer ad oluşturmak için veya New-AliaskullanınSet-Alias. Diğer adı değiştirmek için kullanın Set-Alias. Diğer adı silmek için kullanın Remove-Alias.