Export-Alias

Modul:

Microsoft.PowerShell.Utility Module

Exportálja az aktuálisan definiált aliasok adatait egy fájlba.

Syntax

ByPath (Alapértelmezett)

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

A Export-Alias parancsmag exportálja az aktuális munkamenet aliasait egy fájlba. Ha a kimeneti fájl nem létezik, a parancsmag létrehozza azt.

Export-Alias exportálhatja az aliasokat egy adott hatókörbe vagy az összes hatókörbe, csv formátumban vagy Set-Alias parancsok sorozataként hozhatja létre az adatokat, amelyeket hozzáadhat egy munkamenethez vagy egy PowerShell-profilhoz.

Példák

1. Példa: Alias exportálása

Export-Alias -Path "Alias.csv"

Ez a parancs exportálja az aktuális aliasadatokat egy Alias.csv nevű fájlba az aktuális könyvtárban.

2. példa: Alias exportálása, kivéve, ha az exportálási fájl már létezik

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

Ez a parancs exportálja az aktuális munkamenet aliasait egy Alias.csv fájlba.

Mivel a NoClobber paraméter van megadva, a parancs sikertelen lesz, ha már létezik Alias.csv fájl az aktuális könyvtárban.

3. példa: Aliasok hozzáfűzése fájlhoz

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

Ez a parancs hozzáfűzi az aktuális munkamenet aliasait a Alias.csv fájlhoz.

A parancs a Description paraméterrel adja hozzá a fájl tetején található megjegyzések leírását.

A parancs a Force paramétert is használja a meglévő Alias.csv fájlok felülírásához, még akkor is, ha írásvédettként vannak jelölve.

4. példa: Aliasok exportálása szkriptként

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

Ez a példa bemutatja, hogyan használhatja az Export-Alias által létrehozott szkriptfájlformátumot.

Az első parancs exportálja a munkamenet aliasait a Alias.ps1 fájlba. A Set-Alias parancsot minden aliashoz tartalmazó fájl létrehozásához a As paramétert a 'Script' értékkel használja.

A második parancs hozzáadja a Alias.ps1 fájl aliasait a CurrentUser-CurrentHost-profilhoz. A profil elérési útja a $PROFILE változóban lesz mentve. A parancs a Get-Content parancsmaggal lekéri az aliasokat a Alias.ps1 fájlból, majd a Add-Content parancsmaggal hozzáadja őket a profilhoz. További információért lásd: about_Profiles.

A harmadik és negyedik parancs hozzáadja az aliasokat a Alias.ps1 fájlban egy távoli munkamenethez a Server01 számítógépen. A harmadik parancs a New-PSSession parancsmaggal hozza létre a munkamenetet. A negyedik parancs a parancsmag Invoke-Command paraméterével futtatja a Alias.ps1 fájlt az új munkamenetben.

Paraméterek

-Append

Azt jelzi, hogy ez a parancsmag hozzáfűzi a kimenetet a megadott fájlhoz ahelyett, hogy felülírja a fájl meglévő tartalmát.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-As

Megadja a kimeneti formátumot. A CSV az alapértelmezett. A paraméter elfogadható értékei a következők:

• CSV. Vesszővel tagolt érték (CSV) formátuma.
• Forgatókönyv. Létrehoz egy Set-Alias parancsot minden exportált aliashoz. Ha a kimeneti fájlt .ps1 fájlnévkiterjesztéssel nevezi el, szkriptként futtatva hozzáadhatja az aliasokat bármely munkamenethez.

Paramétertulajdonságok

Típus:	ExportAliasFormat
Alapértelmezett érték:	None
Elfogadott értékek:	Csv, Script
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Description

Az exportált fájl leírását adja meg. A leírás megjegyzésként jelenik meg a fájl tetején, a fejlécinformációkat követve.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Felülírja a kimeneti fájlt, még akkor is, ha az írásvédett attribútum be van állítva a fájlon.

Alapértelmezés szerint Export-Alias figyelmeztetés nélkül felülírja a fájlokat, kivéve, ha az írásvédett vagy rejtett attribútum be van állítva, vagy a NoClobber paramétert használja a parancs. A NoClobber paraméter elsőbbséget élvez a Force paraméterrel szemben, ha mindkettőt egy parancsban használják.

A Erő paraméter nem tudja kényszeríteni Export-Alias-t a rejtett attribútummal rendelkező fájlok felülírására.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-LiteralPath

Megadja a kimeneti fájl elérési útját. A Path-tal ellentétben a LiteralPath paraméter értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	PSPath, LP

Paraméterkészletek

ByLiteralPath

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Name

Az exportálandó aliasok tömbjeként adja meg a neveket. Helyettesítő karakterek használata engedélyezett.

Alapértelmezés szerint Export-Alias exportálja a munkamenet vagy a hatókör összes aliasát.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

(All)

Position:	1
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-NoClobber

Azt jelzi, hogy ez a parancsmag megakadályozza, hogy Export-Alias felülírja a fájlokat, még akkor is, ha az Force paramétert használja a parancs.

Ha a NoClobber paraméter nincs megadva, Export-Alias figyelmeztetés nélkül felülír egy meglévő fájlt, kivéve, ha a csak olvasható attribútum be van állítva a fájlon. NoClobber elsőbbséget élvez a Force paraméterrel szemben, amely engedélyezi, hogy Export-Alias felülírjon egy írásvédett attribútummal rendelkező fájlt.

NoClobber nem akadályozza meg, hogy a Hozzáfűző paraméter tartalmat adjon hozzá egy meglévő fájlhoz.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	NoOverwrite

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Path

Megadja a kimeneti fájl elérési útját. A helyettesítő karakterek használata engedélyezett, de az eredményül kapott elérési út értékét egyetlen fájlnévre kell feloldani.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

ByPath

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Scope

Megadja azt a hatókört, amelyből az aliasokat exportálni kell. A paraméter elfogadható értékei a következők:

• Global
• Local
• Script
• Az aktuális hatókörhöz viszonyított szám (0 és az összes hatókör száma között, ahol 0 az aktuális hatókör, 1 pedig a szülő hatókör)

Az alapértelmezett érték a Local. További információ található a about_Scopesrészben.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

AliasInfo

A PassThru paraméter használatakor ez a parancsmag egy AliasInfo objektumot ad vissza, amely az aliast jelöli.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Export-Alias:

• Minden platform:
  • epal

• Csak Export-Aliases-t végezhet el egy fájlon.

Kapcsolódó hivatkozások

• Get-Alias
• Import-Alias
• Új Alias
• Álnév-beállítás