Aracılığıyla paylaş

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. kullanılarak 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 İçerik Oluşturucu

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 bir diğer ad İçerik Oluşturucu

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 salt okunur hale getirir. Komutun son satırı, yeni diğer adı almak için kullanır Get-Alias ve bu diğer adı, hakkındaki tüm bilgileri görüntülemek üzere Format-List ile eş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 zaten varsa 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 bayrağı ayarlamak için birden çok değeri birleştirebilirsiniz. Değerler Option parametresine bir değer dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak geçirilebilir. cmdlet'i, değerleri ikili OR işlemi kullanarak birleştirir. Değerleri dizi olarak geçirmek en basit seçenektir ve değerlerde 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 çıktı üretmez.

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 ü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 adı alınan 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

Bu cmdlet'e giriş kanalı yapamazsınız.

Çıkışlar

None or System.Management.Automation.AliasInfo

Passthru parametresini kullandığınızda, New-Alias yeni diğer adı temsil eden bir System.Management.Automation.AliasInfo nesnesi oluşturur. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.

Notlar

  • 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-Item.