Set-Alias

Syntax

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

Description

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

Cmdlet'in birden çok diğer adı olabilir, ancak bir diğer ad yalnızca bir cmdlet ile ilişkilendirilebilir. Varolan bir diğer adı başka bir cmdlet'e yeniden atamak veya diğer adın açıklaması gibi özelliklerini değiştirmek için kullanabilirsiniz Set-Alias .

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

Örnekler

Örnek 1: Cmdlet için diğer ad oluşturma

Bu komut, geçerli PowerShell oturumunda bir cmdlet için bir diğer ad oluşturur.

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

PS> Get-Alias -Name list

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

Cmdlet, Set-Alias geçerli PowerShell oturumunda bir diğer ad oluşturur. Name parametresi diğer adın adını listbelirtir. Value parametresi, diğer adın çalıştırıldığı cmdlet'i belirtir.

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

Örnek 2: Var olan diğer adı farklı bir cmdlet'e yeniden atama

Bu komut, farklı bir cmdlet çalıştırmak için var olan bir diğer 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

Cmdlet, Get-Alias diğer adı görüntülemek için Name parametresini list kullanır. Diğer list ad, cmdlet'iyle Get-ChildItem ilişkilendirilir. list Diğer ad çalıştırıldığında, geçerli dizindeki öğeler görüntülenir.

Cmdlet, Set-Alias diğer adı belirtmek için Name parametresini list kullanır. Value parametresi diğer adı cmdlet'iyle Get-Location ilişkilendirir.

Cmdlet, Get-Alias diğer adı görüntülemek için Name parametresini list kullanır. Diğer list ad, cmdlet'iyle Get-Location ilişkilendirilir. list Diğer ad çalıştırıldığında geçerli dizinin konumu görüntülenir.

Örnek 3: Salt okunur diğer ad oluşturma ve değiştirme

Bu komut salt okunur bir diğer ad oluşturur. Salt okunur seçeneği, diğer adlarda istenmeyen değişiklikleri engeller. Salt okunur bir diğer 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

Cmdlet, Set-Alias geçerli PowerShell oturumunda bir diğer ad oluşturur. Name parametresi diğer adın adını locbelirtir. Value parametresi, diğer adın Get-Location çalıştırıldığı cmdlet'i belirtir. Option parametresi ReadOnly değerini belirtir. PassThru parametresi diğer ad nesnesini temsil eder ve nesneyi işlem hattından cmdlet'ine Format-List gönderir. Format-List her özelliğin görüntülenmesi için Property parametresini bir yıldız işareti (*) ile kullanır. Örnek çıktıda bu özelliklerin kısmi bir listesi gösterilir.

Diğer loc ad, iki parametre eklendiğinde değiştirilir. Açıklama , diğer adın amacını açıklamak için metin ekler. Diğer ad salt okunur olduğundan loc Force parametresi gereklidir. Force parametresi kullanılmazsa, değişiklik başarısız olur.

Örnek 4: Yürütülebilir dosyaya diğer ad oluşturma

Bu örnek, yerel bilgisayardaki yürütülebilir dosya için bir diğer ad oluşturur.

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

PS> Get-Alias -Name np

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

Cmdlet, Set-Alias geçerli PowerShell oturumunda bir diğer ad oluşturur. Name parametresi diğer adın adını npbelirtir. Value parametresi yolu ve uygulama adını C:\Windows\notepad.exebelirtir. Cmdlet, Get-Alias diğer adın ile notepad.exeilişkilendirildiğini np göstermek için Name parametresini kullanır.

Diğer adı çalıştırmak için PowerShell komut satırına yazarak np dosyasını açın notepad.exe.

Örnek 5: Parametrelerle bir komut için diğer ad oluşturma

Bu örnekte, parametrelerle bir komuta diğer ad atama gösterilmektedir.

Cmdlet için gibi Set-Locationbir diğer ad oluşturabilirsiniz. Gibi parametreler ve değerler Set-Location -Path C:\Windows\System32içeren bir komut için diğer ad oluşturamazsınız. Bir komut için diğer ad oluşturmak için, komutunu içeren bir işlev oluşturun ve ardından işlev için bir diğer 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

adlı CD32 bir işlev oluşturulur. işlevi, dizini C:\Windows\System32belirtmek Set-Location için Path parametresiyle cmdlet'ini kullanır.

Cmdlet, Set-Alias geçerli PowerShell oturumundaki işlev için bir diğer ad oluşturur. Name parametresi diğer adın adını Gobelirtir. Value parametresi işlevin adını CD32belirtir.

Diğer adı çalıştırmak için PowerShell komut satırına yazın Go . CD32 İşlev çalışır ve dizinine C:\Windows\System32geçer.

Örnek 6: Mevcut diğer ad için güncelleştirme seçenekleri

Bu örnekte Option parametresini kullanarak birden çok seçeneğin nasıl atanacakları gösterilmektedir.

Önceki örnekten devam ederek diğer adı Go ve Privateolarak ReadOnly ayarlayın.

Set-Alias -Name Go -Option ReadOnly, Private

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

Parametreler

-Confirm

-Description

-Force

-Name

-Option

-PassThru

-Scope

-Value

-WhatIf

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 diğer adı temsil eden bir AliasInfo nesnesi döndürür.

Notlar

PowerShell için aşağıdaki diğer adları Set-Aliasiçerir:

• Tüm platformlar:
  • sal

PowerShell, her PowerShell oturumunda kullanılabilen yerleşik diğer adlar içerir. Cmdlet bir Get-Alias PowerShell oturumunda kullanılabilen diğer adları görüntüler.

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

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

Diğer ad, dışarı ve içeri aktarma işlemi yapılarak başka bir PowerShell oturumunda kaydedilebilir ve yeniden kullanılabilir. Diğer adı bir dosyaya kaydetmek için kullanın Export-Alias. Yeni bir PowerShell oturumuna kaydedilmiş bir diğer ad eklemek için kullanın Import-Alias.

İlişkili Bağlantılar

• about_Aliases
• about_Functions
• about_Profiles
• about_Scopes
• Export-Alias
• Get-Alias
• Import-Alias
• New-Alias
• Remove-Alias
• Remove-Item