Import-Alias

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee importeert u een aliaslijst uit een bestand.

Syntax

Import-Alias
      [-Path] <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Import-Alias
      -LiteralPath <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De Import-Alias cmdlet importeert een aliaslijst uit een bestand.

Vanaf Windows PowerShell 3.0, als beveiligingsfunctie, Import-Alias worden bestaande aliassen niet standaard overschreven. Als u een bestaande alias wilt overschrijven, gebruikt u de parameter Force nadat u zeker hebt dat de inhoud van het aliasbestand veilig is.

Voorbeelden

Voorbeeld 1: Aliassen importeren uit een bestand

Import-Alias test.txt

Met deze opdracht importeert u aliasgegevens uit een bestand met de naam test.txt.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Force

Hiermee kan de cmdlet een alias importeren die al is gedefinieerd of alleen-lezen is. U kunt de volgende opdracht gebruiken om informatie weer te geven over de momenteel gedefinieerde aliassen:

Get-Alias | Select-Object Name, Options

Als de bijbehorende alias het kenmerk Alleen-lezen heeft, wordt deze weergegeven in de waarde van de eigenschap Opties .

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

-LiteralPath

Hiermee geeft u het pad naar een bestand met geëxporteerde aliasgegevens. In tegenstelling tot de parameter Path wordt de waarde van de parameter LiteralPath exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

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

-Path

Hiermee geeft u het pad naar een bestand met geëxporteerde aliasgegevens. Jokertekens zijn toegestaan, maar ze moeten worden omgezet in één naam.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Scope

Hiermee geeft u het bereik op waarin de aliassen worden geïmporteerd. De aanvaardbare waarden voor deze parameter zijn:

  • Globaal
  • Lokaal
  • Script
  • Een getal ten opzichte van het huidige bereik (0 tot het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik is)

De standaardwaarde is Lokaal. Zie about_Scopes voor meer informatie.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String

U kunt een tekenreeks met een pad naar deze cmdlet doorsluisen.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

AliasInfo

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een AliasInfo-object dat de alias vertegenwoordigt.

Notities

PowerShell bevat de volgende aliassen voor Import-Alias:

  • Alle platforms:
    • ipal