Sdílet prostřednictvím

Remove-Variable

  • Reference
Modul:
Microsoft.PowerShell.Utility

Odstraní proměnnou a její hodnotu.

Syntaxe

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í.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Name

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

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.