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 als u ervoor hebt gezorgd 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
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
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 precies gebruikt zoals deze wordt 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 moeten worden geïnterpreteerd als escapereeksen.

Type:	String
Aliases:	PSPath, LP
Position:	Named
Default value:	None
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
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
Accept pipeline input:	True
Accept wildcard characters:	True

-Scope

Hiermee geeft u het bereik 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 en met 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
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
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

String

U kunt een tekenreeks met een pad naar Import-Alias.

Uitvoerwaarden

None or System.Management.Automation.AliasInfo

Wanneer u de parameter Passthru gebruikt, Import-Alias wordt een System.Management.Automation.AliasInfo-object geretourneerd dat de alias vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.