Dela via


New-Alias

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

PS C:\> New-Alias -Name "List" Get-ChildItem

Det här kommandot skapar ett alias med namnet List som representerar cmdleten Get-ChildItem.

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

PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *

Det här kommandot skapar ett alias med namnet W som representerar cmdleten Get-WmiObject. 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:

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

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 denna cmdlet 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
  • 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).

Lokal är standardinställningen. 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 indata till denna cmdlet.

Utdata

None or System.Management.Automation.AliasInfo

När du använder parametern Passthru genererar New-Alias ett System.Management.Automation.AliasInfo-objekt som representerar det nya aliaset. Annars genererar denna cmdlet inga utdata.

Kommentarer

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