Share 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 or System.Management.Automation.AliasInfo

När du använder parametern Export-AliasPassthru returnerar ett System.Management.Automation.AliasInfo-objekt som representerar aliaset. Annars genererar denna cmdlet inga utdata.

Kommentarer

  • Du kan bara Export-Aliases till en fil.