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.

Set-Alias tarafından 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

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.

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 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, her özelliğin görüntülenmesi için Özelliği parametresini yıldız işaretiyle (*) 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. Zorla 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. Değeri parametresi, C:\Windows\notepad.exeyolunu ve uygulama adını belirtir. Get-Alias cmdlet'i, diğer adının npile ilişkilendirildiğini göstermek için notepad.exe parametresini kullanır.

Diğer adı çalıştırmak için PowerShell komut satırına np yazarak notepad.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. Set-Location -Path C:\Windows\System32gibi parametreler ve değerler iç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

CD32 adlı bir işlev oluşturulur. işlevi, Set-Locationdizinini belirtmek için Path parametresiyle C:\Windows\System32 cmdlet'ini 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. CD32 işlevi çalışır ve C:\Windows\System32dizinine değişir.

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

Bu örnekte, Option parametresi kullanılarak birden çok seçeneğin nasıl atanacakları gösterilmektedir.

Önceki örnekten devam ederek diğer GoReadOnly ve Privateolarak ayarlayın.

Set-Alias -Name Go -Option ReadOnly, Private

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

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ç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.

Zorla parametresi, Option parametresi Sabitolarak 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 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, diğer adı istenmeyen değişikliklerden 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:

AllScope - Diğer ad, oluşturulan tüm yeni kapsamlara kopyalanır.
Constant - Değiştirilemez veya silinemez.
None - Seçenek belirlemez ve varsayılan seçenektir.
Private - Diğer ad yalnızca geçerli kapsamda kullanılabilir.
ReadOnly - Zorla 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 birlikte birleştirebilirsiniz. Değerler Option parametresine bir değer dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak geçirilebilir. Cmdlet, değerleri ikili VEYA işlemi kullanarak 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.

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
Local
Private
Numbered scopes
Script

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ılmıyor.

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

Notlar

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

sal

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.

Yeni bir diğer ad oluşturmak için Set-Alias veya New-Aliaskullanın. Diğer adı kaldırmak için Remove-Item cmdlet'ini kullanın. Örneğin, Remove-Item -Path Alias:aliasname.

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.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

Set-Alias

Syntax

Default (Varsayılan)

Description

Örnekler

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

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

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

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

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

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

Parametreler

-Confirm

Parametre özellikleri

Parametre kümeleri

-Description

Parametre özellikleri

Parametre kümeleri

-Force

Parametre özellikleri

Parametre kümeleri

-Name

Parametre özellikleri

Parametre kümeleri

-Option

Parametre özellikleri

Parametre kümeleri

-PassThru

Parametre özellikleri

Parametre kümeleri

-Scope

Parametre özellikleri

Parametre kümeleri

-Value

Parametre özellikleri

Parametre kümeleri

-WhatIf

Parametre özellikleri

Parametre kümeleri

CommonParameters

Girişler

None

Çıkışlar

None

AliasInfo

Notlar

İlişkili Bağlantılar

Geri Bildirim