Aracılığıyla paylaş

New-Alias

Modül:
Microsoft.PowerShell.Utility Module

Yeni bir diğer ad oluşturur.

Syntax

Default (Varsayılan) 

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

Description

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

Ö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, C cmdlet'ini temsil etmek için Get-ChildItem adlı 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]…}

Get-Alias'a yöneltilen Format-List komutu, 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 Set-ParentDirectory kullanan Set-Locationişlevini oluşturur. İkinci komut, New-Alias işlevini çağırmak üzere .. diğer adını oluşturmak için Set-ParentDirectory kullanır. 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ı .. çalıştırmak geçerli konumu üst dizine değiştirir.

Parametreler

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Force

cmdlet'in, adlı diğer ad zaten varsa Set-Alias gibi davrandığını gösterir.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Option

Diğer adın Seçenekleri özelliğinin değerini belirtir. Geçerli değerler şunlardır:

  • None: Takma adın herhangi bir kısıtlaması yok (varsayılan değer)
  • ReadOnly: Diğer ad silinebilir ancak Zorla parametresi kullanılarak değiştirilemez
  • Constant: Diğer ad silinemez veya değiştirilemez
  • Private: Diğer ad yalnızca mevcut 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 Seçenekleri özelliğini görmek için Get-Alias | Format-Table -Property Name, Options -AutoSizeyazın.

Parametre özellikleri

Tür:ScopedItemOptions
Default value:[System.Management.Automation.ScopedItemOptions]::None
Kabul edilen değerler:None, ReadOnly, Constant, Private, AllScope, Unspecified
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Scope

Yeni diğer adın kapsamını belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

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

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Value

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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, New-Aliasiçin aşağıdaki diğer adları içerir:

  • Tüm platformlar:

    • nal

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