Set-Alias

Modül:

Microsoft.PowerShell.Utility Module

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

Syntax

Default (Varsayılan)

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

Description

Set-Alias cmdlet'i 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, salSet-Alias cmdlet'inin 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. Mevcut diğer adı başka bir cmdlet'e yeniden atamak için Set-Alias kullanabilir veya açıklama gibi diğer adın özelliklerini değiştirebilirsiniz.

Tarafından Set-Alias oluşturulan veya değiştirilen bir 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

Set-Alias cmdlet'i geçerli PowerShell oturumunda bir diğer ad oluşturur. Adı 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 list yazın.

Ö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

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

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

Get-Alias cmdlet'i, diğer adını görüntülemek için list parametresini kullanır. list diğer adı Get-Location cmdlet'iyle 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.

PS> 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

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -Description 'Displays the current directory' -Force -PassThru | 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 diğer ad oluşturur. Adı parametresi diğer adın adını locbelirtir. Value parametresi, diğer adın çalıştırıldığı Get-Location cmdlet'ini belirtir. Option parametresi ReadOnly değerini belirtir. PassThru parametresi diğer ad nesnesini temsil eder ve nesneyi işlem hattından Format-List cmdlet'ine gönderir. Format-List tüm özelliklerin 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.

loc diğer 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 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

Set-Alias cmdlet'i geçerli PowerShell oturumunda bir diğer ad oluşturur. Adı parametresi diğer adın adını npbelirtir. Value parametresi, yolu ve uygulama adını C:\Windows\notepad.exebelirtir. CmdletGet-Alias, diğer adın notepad.exeile ilişkilendirildiğini göstermek için np parametresini kullanır.

Diğer adı çalıştırmak için PowerShell komut satırına yazarak npnotepad.exeaçın.

Ö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 için Set-Locationgibi bir 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.

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

PS> Set-Alias -Name Go -Value CD32

CD32 adlı bir işlev oluşturulur. İşlev, Set-LocationC:\Windows\System32 dizinini belirtmek için Path parametresiyle cmdlet'i kullanır.

Set-Alias cmdlet'i geçerli PowerShell oturumunda işlev için bir diğer ad oluşturur. Adı 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 Go yazın. İşlev CD32 çalışır ve C:\Windows\System32 dizinine geçer.

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, tek tırnak işaretleri 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

Option parametresi ReadOnly olarak ayarlanmış bir diğer adı değiştirmek veya silmek içinZorla parametresini kullanın.

Force parametresi, Option parametresi Sabit olarak ayarlanmış bir diğer adı değiştiremez veya silemez.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
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ın adını belirtir. Diğer ad, alfasayısal karakterler ve kısa çizgiler içerebilir. Diğer ad adları 123 gibi sayısal 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 Option özellik değerini ayarlar. ReadOnly ve Constant gibi değerler, bir diğer adı istenmeyen değişikliklere karşı korur. Oturumdaki tüm diğer adların Option özelliğini görmek için Get-Alias | Format-Table -Property Name, Options -Autosizeyazın.

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

• Tüm Kapsam Diğer ad, oluşturulan tüm yeni kapsamlara kopyalanır.
• Sabit Değiştirilemez veya silinemez.
• Hiç kimse Hiçbir seçeneği ayarlamaz ve varsayılandır.
• Özel Diğer ad yalnızca geçerli kapsamda kullanılabilir.
• Salt OkunurForce parametresi kullanılmadığı sürece değiştirilemez veya silinemez.
• Belirtilme -miş

Parametre özellikleri

Tür:	ScopedItemOptions
Default value:	None
Kabul edilen değerler:	AllScope, Constant, None, Private, ReadOnly, 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

Diğer adı temsil eden bir nesne döndürür. Nesneyi görüntülemek için Format-List gibi bir biçim cmdlet'i kullanın. Varsayılan olarak, Set-Alias 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

Bu diğer adın geçerli olduğu kapsamı belirtir. Varsayılan değer yerel değeridir. Daha fazla bilgi için bkz. about_Scopes.

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

• Global
• Yerel
• Özel
• Numaralandırılmış kapsamlar
• Senaryo

Parametre özellikleri

Tür:	String
Default value:	Local
Kabul edilen değerler:	Global, Local, Private, Numbered scopes, Script
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 adın çalıştırıldığı cmdlet veya komutun adını belirtir. Değeri parametresi, diğer adın Tanım özelliğidir.

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

Set-Alias işlem hattından giriş kabul etmez.

Çıkışlar

None or System.Management.Automation.AliasInfo

PassThru parametresini kullandığınızda, Set-Alias diğer adı temsil eden bir System.Management.Automation.AliasInfo nesnesi oluşturur. Aksi takdirde, Set-Alias herhangi bir çıktı oluşturmaz.

Notlar

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

Diğer ad oluşturmak için Set-Alias veya New-Aliascmdlet'lerini kullanın. PowerShell 6'da diğer adı silmek için Remove-Alias cmdlet'ini kullanın. Remove-Item, PowerShell'in önceki sürümleriyle oluşturulan betikler gibi geriye dönük uyumluluk için kabul edilir. Remove-Item -Path Alias:aliasnamegibi bir 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 Export-Aliaskullanın. Yeni bir PowerShell oturumuna kaydedilmiş bir diğer ad eklemek için Import-Aliaskullanın.

İlişkili Bağlantılar

• Aliases Hakkında
• Fonksiyonlar_Hakkında
• Profiller_Hakkında
• Hakkında_Scopes
• Takma Adı Dışa Aktar
• Get-Alias
• Import-Alias
• Yeni-Takma Ad
• Takma Adı Kaldır
• Ögeyi Kaldır