New-Alias

  • Referens
Modul:
Microsoft.PowerShell.Utility

Skapar ett nytt alias.

Syntax

New-Alias
   [-Name] <String>
   [-Value] <String>
   [-Description <String>]
   [-Option <ScopedItemOptions>]
   [-PassThru]
   [-Scope <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-Alias skapar ett nytt alias i den aktuella PowerShell-sessionen. Alias som skapas med hjälp New-Alias av sparas inte när du har avslutat sessionen eller stängt PowerShell. Du kan använda cmdleten Export-Alias för att spara aliasinformationen i en fil. Du kan senare använda Import-Alias för att hämta den sparade aliasinformationen.

Exempel

Exempel 1: Skapa ett alias för en cmdlet

New-Alias -Name "List" Get-ChildItem

Det här kommandot skapar ett alias med namnet List för att representera cmdleten Get-ChildItem.

Exempel 2: Skapa ett skrivskyddat alias för en cmdlet

Det här kommandot skapar ett alias med namnet C för att representera cmdleten Get-ChildItem . Den skapar en beskrivning av "quick gci alias" för aliaset och gör det skrivskyddat.

New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

Kommandot Get-Alias som skickas till Format-List visar all information om det nya aliaset.

Exempel 3: Skapa ett alias för ett kommando med parametrar

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

Det första kommandot skapar funktionen Set-ParentDirectory, som använder Set-Location för att ange arbetsplatsen till den överordnade katalogen. Det andra kommandot använder New-Alias för att skapa ett alias .. för för att anropa Set-ParentDirectory funktionen. Eftersom parametern Value kräver ett cmdlet-, funktions- eller körbart värde måste du skapa en anpassad funktion för att skapa ett alias som använder parametrar. Om du kör aliaset .. ändras den aktuella platsen till den överordnade katalogen.

Parametrar

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Anger en beskrivning av aliaset. Du kan skriva valfri sträng. Om beskrivningen innehåller blanksteg omger du den inom citattecken.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att cmdleten fungerar som Set-Alias om aliaset med namnet redan finns.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger det nya aliaset. Du kan använda alfanumeriska tecken i ett alias, men det första tecknet får inte vara ett tal.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Option

Anger värdet för egenskapen Alternativ för aliaset. Giltiga värden är:

  • None: Aliaset har inga begränsningar (standardvärde)
  • ReadOnly: Aliaset kan tas bort men kan inte ändras förutom med hjälp av force-parametern
  • Constant: Aliaset kan inte tas bort eller ändras
  • Private: Aliaset är endast tillgängligt i det aktuella omfånget
  • AllScope: Aliaset kopieras till alla nya omfång som skapas
  • Unspecified: Alternativet har inte angetts

Dessa värden definieras som en flaggbaserad uppräkning. Du kan kombinera flera värden för att ange flera flaggor med hjälp av den här parametern. Värdena kan skickas till parametern Alternativ som en matris med värden eller som en kommaavgränsad sträng av dessa värden. Cmdleten kombinerar värdena med hjälp av en binär-OR-åtgärd. Att skicka värden som en matris är det enklaste alternativet och du kan även använda tab-completion på värdena.

Om du vill se egenskapen Alternativ för alla alias i sessionen skriver du Get-Alias | Format-Table -Property Name, Options -AutoSize.

Typ:ScopedItemOptions
Godkända värden:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Standardvärde:[System.Management.Automation.ScopedItemOptions]::None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Scope

Anger omfånget för det nya aliaset. De acceptabla värdena för den här parametern är:

  • Global
  • Local
  • Script
  • 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).

Local används som standard. Mer information finns i about_Scopes.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Value

Anger namnet på cmdleten eller kommandoelementet som aliaseras.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

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

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

AliasInfo

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

Kommentarer

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

  • Alla plattformar:

    • nal

  • Om du vill skapa ett nytt alias använder du Set-Alias eller New-Alias. Om du vill ändra ett alias använder du Set-Alias. Om du vill ta bort ett alias använder du Remove-Alias.