Aracılığıyla paylaş

Export-Alias

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

Şu anda tanımlanmış diğer adlar hakkındaki bilgileri bir dosyaya aktarır.

Syntax

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

Description

cmdlet'i Export-Alias geçerli oturumdaki diğer adları bir dosyaya aktarır. Çıkış dosyası yoksa, cmdlet onu oluşturur.

Export-Alias belirli bir kapsamdaki veya tüm kapsamlardaki diğer adları dışarı aktarabilir, verileri CSV biçiminde veya oturuma veya PowerShell profiline ekleyebileceğiniz bir dizi Set-Alias komutu olarak oluşturabilir.

Örnekler

Örnek 1: Diğer adı dışarı aktarma

Export-Alias -Path "alias.csv"

Bu komut geçerli diğer ad bilgilerini geçerli dizindeki Alias.csv adlı bir dosyaya aktarır.

Örnek 2: Dışarı aktarma dosyası zaten yoksa diğer adı dışarı aktarma

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

Bu komut geçerli oturumdaki diğer adları bir Alias.csv dosyasına aktarır.

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

Örnek 3: Dosyaya diğer ad ekleme

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

Bu komut geçerli oturumdaki diğer adları Alias.csv dosyasına ekler.

komut, dosyanın en üstündeki açıklamalara açıklama eklemek için Description parametresini kullanır.

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

Örnek 4: Diğer adları betik olarak dışarı aktarma

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 örnekte, oluşturulan betik dosyası biçiminin Export-Alias nasıl kullanılacağı gösterilmektedir.

İlk komut oturumdaki diğer adları Alias.ps1 dosyasına aktarır. Her diğer ad için bir Set-Alias komutu içeren bir dosya oluşturmak için Betik değeriyle As parametresini kullanır.

İkinci komut, Alias.ps1 dosyasındaki diğer adları CurrentUser-CurrentHost profiline ekler. Profilin yolu değişkene $Profile kaydedilir. komutu, Alias.ps1 dosyasındaki diğer adları almak için cmdlet'ini Add-Content ve bunları profile eklemek için cmdlet'ini kullanırGet-Content. Daha fazla bilgi için bkz. about_Profiles.

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

Parametreler

-Append

Bu cmdlet'in, bu dosyanın varolan içeriğinin üzerine yazmak yerine çıkışı belirtilen dosyaya eklediğini gösterir.

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

-As

Çıkış biçimini belirtir. CSV varsayılan değerdir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • CSV. Virgülle ayrılmış değer (CSV) biçimi.
  • Betik. Dışarı aktarılan her diğer ad için bir Set-Alias komut oluşturur. Çıktı dosyasını bir .ps1 dosya adı uzantısıyla adlandırırsanız, diğer adları herhangi bir oturuma eklemek için betik olarak çalıştırabilirsiniz.
Type:ExportAliasFormat
Accepted values:Csv, Script
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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

Dışarı aktarılan dosyanın açıklamasını belirtir. Açıklama, üst bilgi bilgilerini izleyerek dosyanın en üstünde açıklama olarak görünür.

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

-Force

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

Salt okunur özniteliği dosyada ayarlanmış olsa bile çıktı dosyasının üzerine yazar.

Salt okunur veya gizli öznitelik ayarlanmadığı veya komutta NoClobber parametresi kullanılmadığı sürece, varsayılan olarak Export-Alias dosyaların üzerine uyarı olmadan yazar. Her ikisi de bir komutta kullanıldığında NoClobber parametresi Force parametresinden önceliklidir.

Force parametresi, gizli özniteliğiyle dosyaların üzerine yazmaya zorlayamazExport-Alias.

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

-LiteralPath

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

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Adları dışarı aktaracak diğer adların dizisi olarak belirtir. Joker karakterlere izin verilir.

Varsayılan olarak, Export-Alias oturum veya kapsamdaki tüm diğer adları dışarı aktarır.

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

-NoClobber

Komutta Force parametresi kullanılsa bile bu cmdlet'in dosyaların üzerine yazılmasını önlediğini Export-Alias gösterir.

NoClobber parametresi atlanırsa, Export-Alias dosyada salt okunur özniteliği ayarlanmadığı sürece, var olan bir dosyanın üzerine uyarı vermeden yazar. NoClobber, salt okunur özniteliğine sahip bir dosyanın üzerine yazılmasını sağlayan Export-AliasForce parametresinden önceliklidir.

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

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

-PassThru

Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak bu cmdlet herhangi bir çıktı üretmez.

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

-Path

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

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

-Scope

Diğer adların dışarı aktarılması gereken kapsamı belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Genel
  • Yerel
  • Komut Dosyası
  • Geçerli kapsama göre bir sayı (0, 0'ın geçerli kapsam ve 1'in üst kapsam olduğu kapsamların sayısı boyunca)

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

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

-WhatIf

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

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 or System.Management.Automation.AliasInfo

Passthru parametresini kullandığınızda, Export-Alias diğer adı temsil eden bir System.Management.Automation.AliasInfo nesnesi döndürür. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.

Notlar

  • Yalnızca bir dosyaya Export-Aliases.