Dela via

New-Alias

Modul:
Microsoft.PowerShell.Utility Module

Skapar ett nytt alias.

Syntax

Default (Standard) 

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

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 funktionen Set-ParentDirectory. 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Description

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:ScopedItemOptions
Standardvärde:[System.Management.Automation.ScopedItemOptions]::None
Godkända värden:None, ReadOnly, Constant, Private, AllScope, Unspecified
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PassThru

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 används som standard. Mer information finns i about_Scopes.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Value

Anger namnet på cmdleten eller kommandoelementet som aliaseras.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.