Export-Alias
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 aliasen 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 filen Alias.csv.
Kommandot använder parametern Beskrivning för att lägga till en beskrivning i kommentarerna överst i filen.
Kommandot använder också force-parametern för att skriva över 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 filen Alias.ps1. 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 filen Alias.ps1 i CurrentUser-CurrentHost-profilen.
Sökvägen till profilen sparas i variabeln $Profile
.
Kommandot använder cmdleten Get-Content
för att hämta aliasen från filen Alias.ps1 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 filen Alias.ps1 i 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 parametern FilePath för cmdleten Invoke-Command
för att köra filen Alias.ps1 i den nya sessionen.
Parametrar
-Append
Anger att den här cmdleten lägger till utdata till 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. CsV-format (Kommaavgränsat värde).
- Skript.
Skapar ett
Set-Alias
kommando för varje exporterat alias. Om du namnger utdatafilen med filnamnstillägget .ps1 kan du köra den som ett skript för att lägga till aliasen 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 precis som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.
Type: | String |
Aliases: | PSPath |
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 den här cmdleten förhindrar att filer skrivs Export-Alias
över, även om force-parametern 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 den här cmdleten 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 Lokalt. 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 den här cmdleten inga utdata.
När du använder parametern PassThru returnerar den här cmdleten ett AliasInfo-objekt som representerar aliaset.
Kommentarer
Windows PowerShell innehåller följande alias för Export-Alias
:
epal
- Du kan bara exportera alias till en fil.
Relaterade länkar
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för