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 skapats med hjälp av New-Alias 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

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

Det här kommandot skapar ett alias med namnet C för att representera cmdleten Get-ChildItem. Den skapar en beskrivning, quick gci alias, för aliaset och gör den skrivskyddad. Den sista raden i kommandot använder Get-Alias för att hämta det nya aliaset och skickar det till Format-List för att visa all information om det.

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 parametern Force
  • 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 godtagbara 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 är 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örs. 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.