Export-Alias

  • Referencia
Modul:
Microsoft.PowerShell.Utility

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

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

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örben vagy az összes hatókörben, létrehozhatja az adatokat CSV formátumban vagy egy munkamenethez vagy PowerShell-profilhoz hozzáadható Set-Alias parancsok sorozataként.

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 meg van adva, a parancs sikertelen lesz, ha egy Alias.csv fájl már létezik 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 Leírás paraméterrel adja hozzá a leírást a fájl tetején található megjegyzésekhez.

A parancs a Force paraméter használatával felülírja a meglévő Alias.csv fájlokat, még akkor is, ha írásvédett attribútummal rendelkeznek.

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 a létrehozott szkriptfájl-formátumot Export-Alias .

Az első parancs exportálja a munkamenet aliasait az Alias.ps1 fájlba. A Szkript értékkel rendelkező As paraméterrel létrehoz egy fájlt, amely minden aliashoz tartalmaz egy Set-Alias parancsot.

A második parancs hozzáadja az 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 az Alias.ps1 fájlból, a Add-Content parancsmag pedig hozzáadja őket a profilhoz. További információ: about_Profiles.

A harmadik és negyedik parancs hozzáadja az Alias.ps1 fájlban lévő aliasokat 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 FilePath paraméterével Invoke-Command futtatja az 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.
  • Szkript. Minden exportált aliashoz létrehoz egy Set-Alias parancsot. Ha a kimeneti fájlt .ps1 fájlnévkiterjesztéssel nevezi el, szkriptként futtatva hozzáadhatja az aliasokat bármely munkamenethez.
Type:ExportAliasFormat
Accepted values:Csv, Script
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 be van állítva az írásvédett vagy rejtett attribútum, 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 parancs használja.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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írt módon lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 az összes aliast a munkamenetben vagy a hatókörben.

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

-NoClobber

Azt jelzi, hogy ez a parancsmag megakadályozza Export-Alias a fájlok felülírását, még akkor is, ha a 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 az írásvédett attribútum be van állítva a fájlon. A NoClobber elsőbbséget élvez a Force paraméterrel szemben, amely lehetővé teszi Export-Alias egy írásvédett attribútummal rendelkező fájl felülírását.

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

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

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Scope

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

  • Globális
  • Helyi
  • Szkript
  • Az aktuális hatókörhöz viszonyított szám (0 azon hatókörök számán keresztül, ahol a 0 az aktuális hatókör, az 1 pedig a szülője)

Az alapértelmezett érték a Helyi érték. További információ: about_Scopes.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

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 Export-Aliastartalmazza:

  • Minden platform:
    • epal
  • Csak fájlba exportálhat aliasokat.