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

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, ett snabbt wmi-alias, för aliaset och gör det skrivskyddat. 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.

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

-Description

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

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

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:ScopedItemOptions
Accepted values:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::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

-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.

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

-Value

Anger namnet på cmdleten eller kommandoelementet som aliaseras.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
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.

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.