Export-Alias
Şu anda tanımlanmış diğer adlar hakkındaki 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>]
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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | ExportAliasFormat |
Kabul edilen değerler: | Csv, Script |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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
.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | String |
Diğer adlar: | PSPath, LP |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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.
Tür: | String[] |
Position: | 1 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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.
Tür: | SwitchParameter |
Diğer adlar: | NoOverwrite |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | String |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
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-Alias
içerir:
- Tüm platformlar:
epal
- Dosyaya yalnızca Diğer Adları Dışarı Aktarabilirsiniz.
İlişkili Bağlantılar
PowerShell