Set-Alias (Microsoft.PowerShell.Utility)

Set-Alias

Modül:
Microsoft.PowerShell.Utility

Geçerli PowerShell oturumunda bir cmdlet veya başka bir komut için takma ad oluşturur veya değiştirir.

Sözdizimi

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

Tanım

Set-Alias cmdlet'i, bir işlev, komut dosyası, dosya veya başka bir yürütülebilir dosya gibi bir cmdlet veya komut için takma ad oluşturur veya değiştirir. Takma ad, bir cmdlet'e veya komuta başvuran alternatif bir addır. Örneğin, sal, Set-Alias cmdlet'inin takma adıdır. Daha fazla bilgi için bkz. about_Aliases.

Bir cmdlet'in birden fazla takma adı olabilir, ancak bir takma ad yalnızca bir cmdlet ile ilişkilendirilebilir. Mevcut bir takma adı başka bir cmdlet'e yeniden atamak veya bir takma adın açıklama gibi özelliklerini değiştirmek için Set-Alias'ı kullanabilirsiniz.

Set-Alias tarafından oluşturulan veya değiştirilen bir takma ad kalıcı değildir ve yalnızca geçerli PowerShell oturumu sırasında kullanılabilir. PowerShell oturumu kapatıldığında takma ad kaldırılır.

Örnekler

Örnek 1: Bir cmdlet için takma ad oluşturma

Bu komut, geçerli PowerShell oturumundaki bir cmdlet'e bir takma ad oluşturur.

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

Set-Alias cmdlet'i geçerli PowerShell oturumunda bir takma ad oluşturur. Ad parametresi takma adın adını (list) belirtir. Value parametresi, takma adın çalıştırdığı cmdlet'i belirtir.

Takma adı çalıştırmak için PowerShell komut satırına list yazın.

Örnek 2: Mevcut bir takma adı farklı bir cmdlet'e yeniden atama

Bu komut, farklı bir cmdlet'i çalıştırmak için mevcut bir takma adı yeniden atar.

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

Get-Alias cmdlet'i, list takma adını görüntülemek için Ad parametresini kullanır. list takma adı, Get-ChildItem cmdlet'iyle ilişkilidir. list takma adı çalıştırıldığında geçerli dizindeki öğeler görüntülenir.

Set-Alias cmdlet'i, list takma adını belirtmek için Ad parametresini kullanır. Value parametresi, takma adı Get-Location cmdlet'iyle ilişkilendirir.

Get-Alias cmdlet'i, list takma adını görüntülemek için Ad parametresini kullanır. list takma adı, Get-Location cmdlet'iyle ilişkilidir. list takma adı çalıştırıldığında geçerli dizinin konumu görüntülenir.

Örnek 3: Salt okunur bir takma ad oluşturma ve değiştirme

Bu komut salt okunur bir takma ad oluşturur. Salt okunur seçeneği, takma adda istenmeyen değişiklikleri önler. Salt okunur bir takma adı değiştirmek veya silmek için Zorla parametresini kullanın.

Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru |
    Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

$Parameters = @{
    Name        =  'loc'
    Value       =  (Get-Location)
    Option      =  'ReadOnly'
    Description =  'Displays the current directory'
    Force       = $true
    PassThru    = $true
}
Set-Alias @Parameters | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

Set-Alias cmdlet'i geçerli PowerShell oturumunda bir takma ad oluşturur. Ad parametresi takma adın adını (loc) belirtir. Value parametresi, takma adın çalıştırdığı Get-Location cmdlet'ini belirtir. Option parametresi ReadOnly değerini belirtir. PassThru parametresi takma ad nesnesini temsil eder ve nesneyi ardışık düzenin aşağısındaki Format-List cmdlet'ine gönderir. Format-List, her özelliğin görüntülenmesi için Özellik parametresini yıldız işaretiyle (*) kullanır. Örnek çıktı bu özelliklerin kısmi bir listesini gösterir.

loc takma adı iki parametrenin eklenmesiyle değiştirildi. Açıklama takma adın amacını açıklayan metin ekler. loc takma adı salt okunur olduğundan Force parametresi gereklidir. Zorla parametresi kullanılmazsa değişiklik başarısız olur.

Örnek 4: Yürütülebilir bir dosyaya takma ad oluşturma

Bu örnek, yerel bilgisayardaki yürütülebilir bir dosyaya bir takma ad oluşturur.

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

Set-Alias cmdlet'i geçerli PowerShell oturumunda bir takma ad oluşturur. Ad parametresi takma adın adını (np) belirtir. Değer parametresi, C:\Windows\notepad.exe yolunu ve uygulama adını belirtir. Get-Alias cmdlet'i, np takma adının notepad.exe ile ilişkili olduğunu göstermek için Ad parametresini kullanır.

Takma adı çalıştırmak için PowerShell komut satırına np yazarak notepad.exe'yi açın.

Örnek 5: Parametreli bir komut için takma ad oluşturma

Bu örnek, parametreler içeren bir komuta nasıl takma ad atanacağını gösterir.

Bir cmdlet için Set-Location gibi bir takma ad oluşturabilirsiniz. Set-Location -Path C:\Windows\System32 gibi parametrelere ve değerlere sahip bir komut için takma ad oluşturamazsınız. Bir komut için takma ad oluşturmak için, komutu içeren bir işlev oluşturun ve ardından işleve bir takma ad oluşturun. Daha fazla bilgi için bkz. about_Functions.

Function CD32 {Set-Location -Path C:\Windows\System32}

Set-Alias -Name Go -Value CD32

CD32 isimli bir fonksiyon yaratıldı. İşlev, C:\Windows\System32 dizinini belirtmek için Path parametresiyle birlikte Set-Location cmdlet'ini kullanır.

Set-Alias cmdlet'i geçerli PowerShell oturumundaki işleve bir takma ad oluşturur. Ad parametresi takma adın adını (Go) belirtir. Value parametresi işlevin adını (CD32) belirtir.

Takma adı çalıştırmak için PowerShell komut satırına Go yazın. CD32 işlevi çalışır ve C:\Windows\System32 dizinine değişir.

Örnek 6: Mevcut bir takma ad için güncelleme seçenekleri

Bu örnek, Option parametresini kullanarak birden çok seçeneğin nasıl atanacağını gösterir.

Önceki örnekten devam ederek Go takma adını ReadOnly ve Private olarak ayarlayın.

Set-Alias -Name Go -Option ReadOnly, Private

Go takma adı zaten mevcut olmalıdır. Komutu çalıştırdıktan sonra takma ad, Force parametresi kullanılmadan değiştirilemez ve yalnızca geçerli kapsamda kullanılabilir.

Parametreler

-Confirm

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

Tip :

SwitchParameter

Takma adlar:

cf

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Description

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

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Force

Option parametresi Salt Okunur olarak ayarlanmış bir takma adı değiştirmek veya silmek için Zorla parametresini kullanın.

Force parametresi, Option parametresi Sabit olarak ayarlandığında takma adı değiştiremez veya silemez.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Name

Yeni bir takma adın adını belirtir. Takma ad, alfasayısal karakterler ve kısa çizgiler içerebilir. Takma adlar 123 gibi sayısal olamaz.

Tip :

String

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Option

Takma adın Option özellik değerini ayarlar. ReadOnly ve Constant gibi değerler, takma adı istenmeyen değişikliklerden korur. Oturumdaki tüm takma adların Option özelliğini görmek için Get-Alias | Format-Tablo -Özellik Adı, Seçenekler -Otomatik Boyutlandırma.

Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:

  • AllScope - Takma ad, oluşturulan tüm yeni kapsamlara kopyalanır.
  • Sabit - Değiştirilemez veya silinemez.
  • Yok - Hiçbir seçeneği ayarlamaz ve varsayılandır.
  • Gizli - Takma ad yalnızca geçerli kapsamda kullanılabilir.
  • ReadOnly - Force parametresi kullanılmadığı sürece değiştirilemez veya silinemez.
    • Unspecified

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 bir araya getirebilirsiniz. Değerler, Option parametresine bir değerler dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak aktarılabilir. Cmdlet, ikili VEYA işlemini kullanarak değerleri birleştirir. Değerleri bir dizi olarak iletmek en basit seçenektir ve aynı zamanda değerler üzerinde sekme tamamlamayı kullanmanıza da olanak tanır.

Tip :

Kapsamlı Öğe Seçenekleri

Kabul edilen değerler:

AllScope, Sabit, Yok, Özel, Salt Okunur, Belirtilmemiş

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-PassThru

Takma adı temsil eden bir nesne döndürür. Nesneyi görüntülemek için Format-List gibi bir format cmdlet'i kullanın. Varsayılan olarak Set-Alias herhangi bir çıktı oluşturmaz.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Scope

Bu takma adın geçerli olduğu kapsamı belirtir. Varsayılan değer Yerel'dir. Daha fazla bilgi için bkz. about_Scopes.

Kabul edilebilir değerler aşağıdaki gibidir:

    Global
    Local
    Private
    Numbered scopes
    Script
Tip :

String

Kabul edilen değerler:

Global, Yerel, Özel, Numaralandırılmış kapsamlar, Komut Dosyası

Konum:

Adlandırılmış

Varsayılan değer:

Yerel

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Value

Takma adın çalıştırdığı cmdlet'in veya komutun adını belirtir. Değer parametresi takma adın Tanım özelliğidir.

Tip :

String

Konum:

1

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-WhatIf

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

Tip :

SwitchParameter

Takma adlar:

wi

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar

Yok

Varsayılan olarak bu cmdlet hiçbir çıktı döndürmez.

AliasInfo

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

Notlar

PowerShell, Set-Alias için aşağıdaki takma adları içerir:

  • Tüm platformlar:

      sal

PowerShell, her PowerShell oturumunda kullanılabilen yerleşik takma adlar içerir. Get-Alias cmdlet'i bir PowerShell oturumunda kullanılabilen takma adları görüntüler.

Bir takma ad oluşturmak için Set-Alias veya New-Alias cmdlet'lerini kullanın. PowerShell 6'da bir takma adı silmek için Remove-Alias cmdlet'ini kullanın. Remove-Item, PowerShell'in önceki sürümleriyle oluşturulan komut dosyaları gibi geriye dönük uyumluluk için kabul edilir. Remove-Item -Path Alias:aliasname gibi bir komut kullanın.

Her PowerShell oturumunda kullanılabilen bir takma ad oluşturmak için bunu PowerShell profilinize ekleyin. Daha fazla bilgi için bkz. about_Profiles.

Bir takma ad, dışarı ve içeri aktarma işlemi yapılarak başka bir PowerShell oturumunda kaydedilebilir ve yeniden kullanılabilir. Bir takma adı bir dosyaya kaydetmek için Export-Alias'ı kullanın. Yeni bir PowerShell oturumuna kayıtlı bir takma ad eklemek için Import-Alias'ı kullanın.

İlgili makaleler