Remove-Variable

  • Reference
Modul:
Microsoft.PowerShell.Utility

Odstraní proměnnou a její hodnotu.

Syntax

Remove-Variable
      [-Name] <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Force]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rutina Remove-Variable odstraní proměnnou a její hodnotu z oboru, ve kterém je definována, například aktuální relace. Tuto rutinu nelze použít k odstranění proměnných, které jsou nastavené jako konstanty nebo proměnné vlastněné systémem.

Příklady

Příklad 1: Odebrání proměnné

Remove-Variable Smp

Tento příkaz odstraní proměnnou $Smp .

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Exclude

Určuje pole položek, které tato rutina vynechá z operace. Hodnota tohoto parametru kvalifikuje parametr Name . Zadejte element nebo vzor názvu, například "s*". Jsou povoleny zástupné cardy.

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

-Force

Označuje, že rutina odebere proměnnou i v případě, že je určená jen pro čtení. I pomocí parametru Force nemůže rutina konstantu odebrat.

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

-Include

Určuje pole položek, které tato rutina odstraní v operaci. Hodnota tohoto parametru kvalifikuje parametr Name . Zadejte element nebo vzor názvu, například s*. Jsou povoleny zástupné cardy.

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

-Name

Určuje název proměnné, která se má odebrat. Název parametru (Name) je volitelný. Jsou povoleny zástupné kóty.

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

-Scope

Získá pouze proměnné v zadaném oboru. Tento parametr přijímá tyto hodnoty:

  • Globální
  • Místní
  • Skript
  • Číslo relativní k aktuálnímu oboru (0 až počet oborů, kde 0 je aktuální obor a 1 je jeho nadřazený)

Místní je výchozí hodnota. Další informace najdete v tématu about_Scopes.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

PSVariable

Objekt proměnné můžete do této rutiny převést.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

PowerShell obsahuje následující aliasy pro Remove-Variable:

  • Všechny platformy:

    • rv

  • Změny ovlivňují pouze aktuální obor, například relaci. Pokud chcete odstranit proměnnou ze všech relací, přidejte do profilu PowerShellu Remove-Variable příkaz.