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 bir oturuma veya PowerShell profiline ekleyebileceğiniz bir dizi Diğer Ad Ayarla 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 bir Alias.csv dosyası zaten 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 ü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 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ından 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, cmdlet'in Invoke-Command FilePath parametresini kullanarak alias.ps1 dosyasını yeni oturumda çalıştırır.

Parametreler

-Append

Bu cmdlet'in, bu dosyanın var olan 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. Çıkış 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 bilgilerinin ardından dosyanın üst kısmında 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.

Dosyada salt okunur özniteliği 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 öznitelikle 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, 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 oturumdaki 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 salt okunur özniteliği dosyada 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-Alias Force 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 çıkış oluşturmaz.

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ılacağı kapsamı belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Global
  • Yerel
  • Komut Dosyası
  • Geçerli kapsama göre bir sayı (0, 0'ın geçerli kapsam, 1'in de onun üst kapsamı olduğu kapsam sayısı üzerinden)

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

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ı Export-Aliasiçerir:

  • Tüm platformlar:
    • epal
  • Dosyaya yalnızca Diğer Adları Dışarı Aktarabilirsiniz.