about_Variable_Provider

Název poskytovatele

Proměnná

Jednotky

Variable:

Možnosti

ShouldProcess

Krátký popis

Poskytuje přístup k proměnným PowerShellu a jejich hodnotám.

Podrobný popis

Zprostředkovatel proměnných PowerShellu umožňuje získat, přidat, změnit, vymazat a odstranit proměnné PowerShellu v aktuální konzole.

Zprostředkovatel proměnné PowerShellu podporuje proměnné, které PowerShell vytvoří, včetně automatických proměnných, proměnných předvoleb a proměnných, které vytvoříte.

Proměnná jednotka je plochý obor názvů, který obsahuje pouze objekty proměnných. Proměnné nemají žádné podřízené položky.

Zprostředkovatel proměnných podporuje následující rutiny, které jsou popsané v tomto článku.

• Získat umístění
• Nastavení umístění
• Získat položku
• Nová položka
• Odebrat položku
• Vymazat položku

PowerShell obsahuje také sadu rutin navržených speciálně pro zobrazení a změnu proměnných. Pokud používáte rutiny Variable , není nutné zadávat jednotku Variable: v názvu. Tento článek se nezabývá prací s rutinami proměnných .

• Get-Variable
• Nová proměnná
• Nastavit proměnnou
• Remove-Variable
• Vymazat proměnnou

Poznámka:

Analyzátor výrazů PowerShellu můžete také použít k vytvoření, zobrazení a změně hodnot proměnných bez použití rutin. Při přímé práci s proměnnými pomocí znaku dolaru ($) identifikujte název jako proměnnou a operátor přiřazení (=)k vytvoření a změně jeho hodnoty. Například $p = Get-Process vytvoří proměnnou p a uloží do ní výsledky Get-Process příkazu.

Typy vystavené tímto poskytovatelem

Proměnné můžou být jedním z několika různých typů. Většina proměnných bude instancí PSVariable třídy. Další proměnné a jejich typy jsou uvedeny níže.

• Proměnná ? je instance QuestionMarkVariable třídy.
• Proměnná null je instance NullVariable třídy.
• Maximální počet proměnných jsou instance SessionStateCapacityVariable třídy.
• LocalVariable instance obsahují informace o aktuálním spuštění, například:
  • MyInvocation
  • PSCommandPath
  • PSScriptRoot
  • PSBoundParameters
  • args
  • input

Navigace na proměnných jednotek

Zprostředkovatel proměnné zveřejňuje své úložiště dat na jednotceVariable:. Pokud chcete pracovat s proměnnými, můžete změnit umístění na jednotku Variable: (Set-Location Variable:) nebo můžete pracovat z libovolné jiné jednotky PowerShellu. Pokud chcete odkazovat na proměnnou z jiného umístění, použijte název jednotky (Variable:) v cestě.

Set-Location Variable:

Pokud se chcete vrátit na jednotku systému souborů, zadejte název jednotky. Zadejte například:

Set-Location C:

S poskytovatelem proměnných můžete pracovat také z libovolné jiné jednotky PowerShellu. Pokud chcete odkazovat na proměnnou z jiného umístění, použijte název Variable: jednotky v cestě.

Poznámka:

PowerShell používá aliasy, které vám umožní pracovat se známým způsobem práce s cestami zprostředkovatele. Příkazy jako dirls a jsou teď aliasy pro Get-ChildItem, cd je alias pro Set-Location. a pwd je alias pro Get-Location.

Zobrazení hodnoty proměnných

Získání všech proměnných v aktuální relaci

Tento příkaz získá seznam všech proměnných a jejich hodnot v aktuální relaci. Tento příkaz můžete použít z libovolné jednotky PowerShellu.

Get-ChildItem -Path Variable:

Získání proměnné pomocí cesty zprostředkovatele

Tento příkaz načte hodnotu proměnných pomocí cesty zprostředkovatele s předponou znaku dolaru ($). To má stejný účinek jako předpona názvu proměnných znakem dolaru ($).

$variable:home

Získání proměnných pomocí zástupných znaků

Tento příkaz získá proměnné s názvy, které začínají na "max". Tento příkaz můžete použít z libovolné jednotky PowerShellu.

Get-ChildItem -Path Variable:max*

Získat hodnotu ? proměnná

Tento příkaz používá -LiteralPath parametr Get-ChildItem k získání hodnoty ? proměnné z Variable: jednotky. Jedná se ? o zástupný znak v cestách, ale Get-ChildItem nepokouší se přeložit žádné zástupné cardy v hodnotách parametru -LiteralPath .

Get-ChildItem -Literalpath ?

Získání proměnných ReadOnly a Konstanta

Tento příkaz získá proměnné, které mají hodnoty nebo ReadOnlyConstant pro jejich vlastnosti Options .

Get-ChildItem -Path Variable: | Where-Object {
   $_.options -Match "Constant" `
   -or $_.options -Match "ReadOnly"
 } | Format-List -Property name, value, options

Vytváření proměnných

Vytvoření nové proměnné

Tento příkaz vytvoří proměnnou servicesGet-Service a uloží do ní výsledky příkazu. Vzhledem k tomu, že aktuální umístění je v Variable: jednotce, je hodnota -Path parametru tečka (.), která představuje aktuální umístění.

Závorky kolem Get-Service příkazu zajišťují, že se příkaz spustí před vytvořením proměnné. Bez závorek je hodnota nové proměnné řetězec Get-Service.

New-Item -Path . -Name services -Value (Get-Service)

Vytvoření proměnné pomocí absolutní cesty

Tento příkaz vytvoří proměnnou services a uloží do ní výsledek Get-Service příkazu.

New-Item -Path Variable:services -Value Get-Service

Pokud chcete vytvořit proměnnou bez hodnoty, vynecháte operátor přiřazení.

Změna proměnných

Přejmenování proměnné

Tento příkaz používá rutinu Rename-Item ke změně názvu a proměnné na processes.

Rename-Item -Path Variable:a -NewName processes

Změna hodnoty proměnné

Tento příkaz pomocí rutiny Set-Item změní hodnotu ErrorActionPreference proměnné na Stop.

Set-Item -Path Variable:ErrorActionPreference -Value Stop

Zkopírování proměnné

Tento příkaz pomocí rutiny Copy-Item zkopíruje proměnnou processes do old_processes. Tím se vytvoří nová proměnná s názvem old_processes , která má stejnou hodnotu jako proměnná processes .

Copy-Item -Path Variable:processes -Destination Variable:old_processes

Odstranění proměnné

Tento příkaz odstraní proměnnou serv z aktuální relace. Tento příkaz můžete použít na libovolné jednotce PowerShellu.

Remove-Variable -Path Variable:serv

Odstranění proměnných pomocí parametru -Force

Tento příkaz odstraní všechny proměnné z aktuální relace s výjimkou proměnných, jejichž Options vlastnost má hodnotu Constant. Bez parametru -Force příkaz neodstraní proměnné, jejichž vlastnost Options má hodnotu ReadOnly.

Remove-Item Variable:* -Force

Nastavení hodnoty proměnné na hodnotu NULL

Tento příkaz používá rutinu Clear-Item ke změně hodnoty processes proměnné na HODNOTU NULL.

Clear-Item -Path Variable:processes

Použití kanálu

Rutiny zprostředkovatele přijímají vstup kanálu. Kanál můžete použít ke zjednodušení úlohy odesláním dat zprostředkovatele z jedné rutiny do jiné rutiny zprostředkovatele. Další informace o tom, jak používat kanál s rutinami zprostředkovatele, najdete v odkazech na rutiny uvedené v tomto článku.

Získání nápovědy

Od windows PowerShellu 3.0 můžete získat přizpůsobená témata nápovědy pro rutiny zprostředkovatele, která vysvětlují, jak se tyto rutiny chovají na jednotce systému souborů.

Pokud chcete získat témata nápovědy, která jsou přizpůsobená pro jednotku systému souborů, spusťte příkaz Get-Help na jednotce systému souborů nebo pomocí -Path parametru Get-Help zadejte jednotku systému souborů.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path variable:

Viz také

• about_Automatic_Variables
• about_Providers
• about_Variables