Export-Alias

Modül:

Microsoft.PowerShell.Utility Module

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

Sözdizimi

ByPath EnterprisePublishing

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

ByLiteralPath

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

Description

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

Export-Alias diğer adları belirli bir kapsamda veya tüm kapsamlarda dışarı aktarabilir, verileri CSV biçiminde veya bir 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 üst kısmındaki 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, Export-Alias oluşturulan betik dosyası biçiminin 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 parametresini kullanır.

İkinci komut, Alias.ps1 dosyasındaki diğer adları CurrentUser-CurrentHost profiline ekler. Profilin yolu $PROFILE değişkenine kaydedilir. komut, Alias.ps1 dosyasındaki diğer adları 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 diğer adları Server01 bilgisayarındaki bir uzak oturuma ekler. Üçüncü komut, oturumu oluşturmak için New-PSSession cmdlet'ini kullanır. Dördüncü komut, yeni oturumda Alias.ps1 dosyasını çalıştırmak için cmdlet'in Invoke-Command parametresini kullanır.

Parametreler

-Append

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-As

Çıkış biçimini belirtir. CSV varsayılan değerdir. Bu parametre için kabul edilebilir değerler ş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 komutu 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.

Parametre özellikleri

Tür:	ExportAliasFormat
Default value:	None
Kabul edilen değerler:	Csv, Script
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Confirm

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Force

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

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

Varsayılan olarak, salt okunur veya gizli öznitelik ayarlanmadığı veya komutta NoClobber parametresi uyarı vermeden dosyaların üzerine yazar. NoClobber parametresi, her ikisi de bir komutta kullanıldığında Zorla parametresinden önceliklidir.

Zorla parametresi, Export-Alias gizli öznitelikle dosyaların üzerine yazmaya zorlayamaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-LiteralPath

Çıkış dosyasının yolunu belirtir. Pathaksine, 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, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	PSPath, LP

Parametre kümeleri

ByLiteralPath

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-NoClobber

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

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

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	NoOverwrite

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

ByPath

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Scope

Diğer adların dışarı aktarılacağı kapsamı belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

• Global
• Local
• Script
• 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 şudur: Local. Daha fazla bilgi için bkz. about_Scopes.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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

• Tüm platformlar:
  • epal

• Yalnızca bir dosyaya Export-Aliases.

İlişkili Bağlantılar

• Get-Alias
• Import-Alias
• Yeni-Takma Ad
• Alias Ayarla