Set-Alias

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

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

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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Option

Diğer adın Option özellik değerini ayarlar. gibi ReadOnly değerler ve Constant diğer adı istenmeyen değişikliklerden korur. Oturumdaki tüm diğer adların Option özelliğini görmek için yazın Get-Alias | Format-Table -Property Name, Options -Autosize.

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 - Hiçbir seçenek belirlemez ve varsayılan seçenektir.
  • Private - Diğer 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 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.

Type:ScopedItemOptions
Accepted values:AllScope, Constant, None, Private, ReadOnly, Unspecified
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Diğer adı temsil eden bir nesne döndürür. Nesnesini görüntülemek için gibi Format-List bir biçim cmdlet'i kullanın. Varsayılan olarak, Set-Alias herhangi bir çıkış oluşturmaz.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Bu diğer 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
Type:String
Accepted values:Global, Local, Private, Numbered scopes, Script
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

Diğer adın çalıştırıldığı cmdlet veya komutun adını belirtir. Value parametresi diğer adın Tanım özelliğidir.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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.