Aracılığıyla paylaş

New-Alias

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

Yeni bir diğer ad oluşturur.

Sözdizimi

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

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ı gci diğer adı" açıklamasını oluşturur ve salt okunur hale getirir.

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]…}

öğesine Get-Alias yöneltilen Format-List komut, yeni diğer ad hakkındaki tüm bilgileri gösterir.

Örnek 3: Parametreleri olan bir komut için diğer ad oluşturma

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

İlk komut, çalışma konumunu üst dizine ayarlamak için kullanan Set-Location işlevini Set-ParentDirectoryoluşturur. İkinci komut işlevini çağırmak Set-ParentDirectory için bir diğer adı .. oluşturmak için kullanırNew-Alias. Value parametresi bir cmdlet, işlev veya yürütülebilir değer gerektirdiğinden, parametreleri kullanan bir diğer ad oluşturmak için özel bir işlev oluşturmanız gerekir. Diğer adın .. çalıştırılması geçerli konumu üst dizin olarak değiştirir.

Parametreler

-Confirm

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

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

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

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:ScopedItemOptions
Kabul edilen değerler:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Value

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

Tür:String
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.