Dela via

Export-Alias

  • Referens
Modul:
Microsoft.PowerShell.Utility

Exporterar information om för närvarande definierade alias till en fil.

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

Cmdleten Export-Alias exporterar aliasen i den aktuella sessionen till en fil. Om utdatafilen inte finns skapar cmdleten den.

Export-Alias kan exportera alias i ett visst omfång eller alla omfång, det kan generera data i CSV-format eller som en serie Set-Alias kommandon som du kan lägga till i en session eller till en PowerShell-profil.

Exempel

Exempel 1: Exportera ett alias

Export-Alias -Path "alias.csv"

Det här kommandot exporterar aktuell aliasinformation till en fil med namnet Alias.csv i den aktuella katalogen.

Exempel 2: Exportera ett alias om inte exportfilen redan finns

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

Det här kommandot exporterar aliasen i den aktuella sessionen till en Alias.csv fil.

Eftersom parametern NoClobber har angetts misslyckas kommandot om det redan finns en Alias.csv fil i den aktuella katalogen.

Exempel 3: Lägga till alias i en fil

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

Det här kommandot lägger till aliasen i den aktuella sessionen i den Alias.csv filen.

Kommandot använder parametern Beskrivning för att lägga till en beskrivning i kommentarerna överst i filen.

Kommandot använder också parametern Force för att skriva över alla befintliga Alias.csv filer, även om de har det skrivskyddade attributet.

Exempel 4: Exportera alias som ett skript

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

Det här exemplet visar hur du använder skriptfilformatet som Export-Alias genererar.

Det första kommandot exporterar aliasen i sessionen till den Alias.ps1 filen. Den använder parametern Som med värdet Skript för att generera en fil som innehåller ett Set-Alias kommando för varje alias.

Det andra kommandot lägger till aliasen i Alias.ps1-filen i profilen CurrentUser-CurrentHost. Sökvägen till profilen sparas i variabeln $Profile . Kommandot använder cmdleten Get-Content för att hämta alias från den Alias.ps1 filen och cmdleten Add-Content för att lägga till dem i profilen. Mer information finns i about_Profiles.

De tredje och fjärde kommandona lägger till aliasen i den Alias.ps1 filen till en fjärrsession på Server01-datorn. Det tredje kommandot använder cmdleten New-PSSession för att skapa sessionen. Det fjärde kommandot använder FilePath-parametern för cmdleten Invoke-Command för att köra Alias.ps1-filen i den nya sessionen.

Parametrar

-Append

Anger att denna cmdlet lägger till utdata i den angivna filen i stället för att skriva över det befintliga innehållet i filen.

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

-As

Anger utdataformatet. CSV är standardinställningen. De acceptabla värdena för den här parametern är:

  • CSV. Kommaavgränsat värdeformat (CSV).
  • Skript. Skapar ett Set-Alias kommando för varje exporterat alias. Om du ger utdatafilen ett .ps1 filnamnstillägg kan du köra den som ett skript för att lägga till alias i valfri session.
Type:ExportAliasFormat
Accepted values:Csv, Script
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Description

Anger beskrivningen av den exporterade filen. Beskrivningen visas som en kommentar överst i filen efter rubrikinformationen.

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

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Skriver över utdatafilen, även om det skrivskyddade attributet har angetts för filen.

Som standard Export-Alias skriver över filer utan varning, såvida inte det skrivskyddade eller dolda attributet har angetts eller parametern NoClobber används i kommandot. Parametern NoClobber har företräde framför parametern Force när båda används i ett kommando.

Force-parametern kan inte tvinga Export-Alias att skriva över filer med det dolda attributet.

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

-LiteralPath

Anger sökvägen till utdatafilen. Till skillnad från Path används värdet för parametern LiteralPath exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken talar om för PowerShell att inga tecken ska tolkas som escape-sekvenser.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Anger namnen som en matris med de alias som ska exporteras. Jokertecken tillåts.

Som standard Export-Alias exporterar alla alias i sessionen eller omfånget.

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

-NoClobber

Anger att denna cmdlet förhindrar att filer skrivs Export-Alias över, även om parametern Force används i kommandot.

Om parametern NoClobber utelämnas Export-Alias skriver du över en befintlig fil utan varning, såvida inte det skrivskyddade attributet har angetts för filen. NoClobber har företräde framför parametern Force , som gör det möjligt Export-Alias att skriva över en fil med det skrivskyddade attributet.

NoClobber förhindrar inte att parametern Append lägger till innehåll i en befintlig fil.

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

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet inga utdata.

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

-Path

Anger sökvägen till utdatafilen. Jokertecken tillåts, men det resulterande sökvägsvärdet måste matchas till ett enda filnamn.

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

-Scope

Anger det omfång som aliasen ska exporteras från. De acceptabla värdena för den här parametern är:

  • Global
  • Lokal
  • Skript
  • Ett tal i förhållande till det aktuella omfånget (0 genom antalet omfång där 0 är det aktuella omfånget och 1 är dess överordnade)

Standardvärdet är Lokal. Mer information finns i about_Scopes.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

None

Som standard returnerar denna cmdlet inga utdata.

AliasInfo

När du använder parametern PassThru returnerar den här cmdleten ett AliasInfo-objekt som representerar aliaset.

Kommentarer

PowerShell innehåller följande alias för Export-Alias:

  • Alla plattformar:
    • epal
  • Du kan bara Export-Aliases till en fil.