Export-Alias (Microsoft.PowerShell.Utility)

Export-Alias

Modül:
Microsoft.PowerShell.Utility

Şu anda tanımlanmış takma adlarla ilgili bilgileri bir dosyaya aktarır.

Sözdizimi

Export-Alias
      [-Path] <String>
      [[-Name] <String[]>]
      [-PassThru]
      [-As <ExportAliasFormat>]
      [-Append]
      [-Force]
      [-NoClobber]
      [-Description <String>]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-Alias
      -LiteralPath <String>
      [[-Name] <String[]>]
      [-PassThru]
      [-As <ExportAliasFormat>]
      [-Append]
      [-Force]
      [-NoClobber]
      [-Description <String>]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Tanım

Export-Alias cmdlet'i geçerli oturumdaki takma adları bir dosyaya aktarır. Çıkış dosyası mevcut değilse cmdlet onu oluşturacaktır.

Export-Alias belirli bir kapsamdaki veya tüm kapsamlardaki takma adları dışa aktarabilir, verileri CSV biçiminde veya bir oturuma veya PowerShell'e ekleyebileceğiniz bir dizi Takma Ad Ayarla komutu olarak oluşturabilir profil.

Örnekler

Örnek 1: Bir takma adı dışa aktarma

Export-Alias -Path "alias.csv"

Bu komut, geçerli takma ad bilgilerini geçerli dizindeki Alias.csv adlı bir dosyaya aktarır.

Örnek 2: Dışa aktarma dosyası zaten mevcut olmadığı sürece bir takma adı dışa aktarın

Export-Alias -Path "alias.csv" -NoClobber

Bu komut, geçerli oturumdaki takma adları bir Alias.csv dosyasına aktarır.

NoClobber parametresi belirtildiğinden, geçerli dizinde bir Alias.csv dosyası zaten mevcutsa komut başarısız olur.

Örnek 3: Bir dosyaya takma ad ekleme

Export-Alias -Path "alias.csv" -Append -Description "Appended Aliases" -Force

Bu komut, geçerli oturumdaki takma adları Alias.csv dosyasına ekler.

Komut, dosyanın üst kısmındaki yorumlara bir açıklama eklemek için Açıklama parametresini kullanır.

Komut ayrıca, salt okunur özniteliğe sahip olsalar bile mevcut Alias.csv dosyalarının üzerine yazmak için Force parametresini de kullanır.

Örnek 4: Takma adları komut dosyası olarak dışa aktarın

Export-Alias -Path "alias.ps1" -As Script
Add-Content -Path $Profile -Value (Get-Content alias.ps1)
$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S -FilePath .\alias.ps1

Bu örnek, Export-Alias'ın oluşturduğu komut dosyası biçiminin nasıl kullanılacağını gösterir.

İlk komut, oturumdaki takma adları Alias.ps1 dosyasına aktarır. Her takma ad için Set-Alias komutunu içeren bir dosya oluşturmak amacıyla Script değeriyle birlikte As parametresini kullanır.

İkinci komut, Alias.ps1 dosyasındaki takma adları CurrentUser-CurrentHost profiline ekler. Profilin yolu $Profile değişkenine kaydedilir. Komut, takma adları Alias.ps1 dosyasından almak için Get-Content cmdlet'ini ve bunları profile eklemek için Add-Content cmdlet'ini kullanır. Daha fazla bilgi için bkz. about_Profiles.

Üçüncü ve dördüncü komutlar Alias.ps1 dosyasındaki takma adları Server01 bilgisayarındaki uzak bir oturuma ekler. Üçüncü komut, oturumu oluşturmak için New-PSSession cmdlet'ini kullanır. Dördüncü komut, Alias.ps1 dosyasını yeni oturumda çalıştırmak için Invoke-Command cmdlet'inin FilePath parametresini kullanır.

Parametreler

-Append

Bu cmdlet'in, söz konusu dosyanın mevcut içeriğinin üzerine yazmak yerine çıktıyı belirtilen dosyaya eklediğini belirtir.

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

-As

Çıkış formatını belirtir. CSV varsayılandır. Bu parametre için kabul edilebilir değerler şunlardır:

  • CSV. Virgülle ayrılmış değer (CSV) biçimi.
  • Senaryo. Dışa aktarılan her takma ad için bir Set-Alias komutu oluşturur. Çıktı dosyasını .ps1 dosya adı uzantısıyla adlandırırsanız, takma adları herhangi bir oturuma eklemek için dosyayı komut dosyası olarak çalıştırabilirsiniz.
Tip :

ExportAliasFormat

Kabul edilen değerler:

Csv, Komut Dosyası

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-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

Dışa aktarılan dosyanın açıklamasını belirtir. Açıklama, dosyanın üst kısmında, başlık bilgilerinin ardından bir yorum olarak görünür.

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

Komutu kullanıcı onayı istemeden çalışmaya zorlar.

Dosyada salt okunur öznitelik ayarlanmış olsa bile çıktı dosyasının üzerine yazar.

Varsayılan olarak Export-Alias, salt okunur veya gizli öznitelik ayarlanmadığı veya komutta NoClobber parametresi kullanılmadığı sürece uyarı vermeden dosyaların üzerine yazar. Bir komutta her ikisi de kullanıldığında, NoClobber parametresi Force parametresine göre önceliklidir.

Force parametresi, Export-Alias'ı gizli özniteliğe sahip dosyaların üzerine yazmaya zorlayamaz.

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

-LiteralPath

Çıkış dosyasının yolunu belirtir. Path'ten farklı olarak LiteralPath parametresinin değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmaz. Yol kaçış karakterleri içeriyorsa, onu tek tırnak işaretleri içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamamasını söyler.

Tip :

String

Takma adlar:

PSPath, LP

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Name

Dışa aktarılacak takma adların dizisi olarak adları belirtir. Joker karakterlere izin verilir.

Varsayılan olarak, Export-Alias oturumdaki veya kapsamdaki tüm takma adları dışa aktarır.

Tip :

String[]

Konum:

1

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-NoClobber

Bu cmdlet'in, komutta Force parametresi kullanılsa bile Export-Alias'ın herhangi bir dosyanın üzerine yazmasını engellediğini belirtir.

NoClobber parametresi atlanırsa, dosyada salt okunur özelliği ayarlanmadığı sürece Export-Alias herhangi bir uyarı yapmadan mevcut dosyanın üzerine yazar. NoClobber, Export-Alias'ın salt okunur özniteliğe sahip bir dosyanın üzerine yazmasına izin veren Force parametresine göre önceliklidir.

NoClobber, Append parametresinin mevcut bir dosyaya içerik eklemesini engellemez.

Tip :

SwitchParameter

Takma adlar:

NoOverwrite

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-PassThru

Üzerinde çalıştığınız öğeyi temsil eden bir nesneyi döndürür. Varsayılan olarak bu cmdlet 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

-Path

Çıkış dosyasının yolunu belirtir. Joker karakterlere izin verilir, ancak elde edilen yol değerinin tek bir dosya adına çözümlenmesi gerekir.

Tip :

String

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-Scope

Takma adların dışarı aktarılması gereken kapsamı belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • Küresel
  • Yerel
  • Senaryo
  • Geçerli kapsama göreli bir sayı (0'ın geçerli kapsam ve 1'in üst öğe olduğu kapsam sayısına kadar 0)

Varsayılan değer Yerel'dir. Daha fazla bilgi için bkz. about_Scopes.

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

-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, Export-Alias için aşağıdaki takma adları içerir:

  • Tüm platformlar:

      epal
  • Takma Adları yalnızca bir dosyaya aktarabilirsiniz.

İlgili makaleler