New-Alias
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
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
Bu komut, C cmdlet'ini temsil etmek için Get-ChildItem adlı bir diğer ad oluşturur. Takma ad için bir açıklama ( quick gci alias) oluşturur ve salt okunur hale getirir. Komutun son satırı, yeni diğer adı almak için kullanılır Get-Alias ve bununla ilgili tüm bilgileri görüntülemek için Format-List yönlendirir.
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:
GlobalLocalScript- Geçerli kapsama göre bir sayı (kapsam sayısı üzerinden 0; burada
0geçerli kapsam ve1onun ü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-AliasveyaNew-Aliaskullanın. Diğer adı değiştirmek içinSet-Aliaskullanın. Diğer adı silmek içinRemove-Aliaskullanın.