about_Quoting_Rules

Krátký popis

Popisuje pravidla použití jednoduchých a dvojitých uvozovek v PowerShellu.

Dlouhý popis

Při analýze powershell nejprve interpretuje vstup jako výraz. Při vyvolání příkazu ale probíhá analýza v režimu argumentu. Nečíselné argumenty bez uvozovek se považují za řetězce. Pokud máte argumenty, které obsahují mezery, například cesty, musíte tyto hodnoty argumentů uzavřít do uvozovek. Další informace o analýze argumentů naleznete v části Režim argumentu about_Parsing.

Uvozovky slouží k zadání literálového řetězce. Řetězec můžete uzavřít do jednoduchých uvozovek (') nebo dvojitých uvozovek (").

Uvozovky se také používají k vytvoření řetězce sem. Zde-řetězec je řetězec s jednoduchým nebo dvojitým uvozovkam, ve kterém jsou uvozovky interpretovány doslova. Zde-řetězec může obsahovat více řádků. Všechny řádky v tomto řetězci se interpretují jako řetězce, i když nejsou uzavřené do uvozovek.

V příkazech pro vzdálené počítače uvozovky definují části příkazu, které jsou spuštěny ve vzdáleném počítači. Ve vzdálené relaci uvozovky také určují, zda jsou proměnné v příkazu interpretovány jako první v místním počítači nebo ve vzdáleném počítači.

Řetězce s dvojitou uvozovou znaky

Řetězec uzavřený do dvojitých uvozovek je rozbalitelný řetězec. Názvy proměnných před znakem dolaru ($) se nahradí hodnotou proměnné před předáním řetězce příkazu ke zpracování.

Příklad:

$i = 5
"The value of $i is $i."

Výstupem tohoto příkazu je:

The value of 5 is 5.

V řetězci s dvojitou uvozovou sadou se také vyhodnocují výrazy a výsledek se vloží do řetězce. Příklad:

"The value of $(2+3) is 5."

Výstupem tohoto příkazu je:

The value of 5 is 5.

Do rozbalitelného řetězce lze přímo vložit pouze základní odkazy na proměnné. Odkazy na proměnné používající indexování pole nebo přístup členů musí být uzavřeny do dílčího výrazu. Příklad:

"PS version: $($PSVersionTable.PSVersion)"

PS version: 7.4.5

Pokud chcete název proměnné oddělit od dalších znaků v řetězci, uzavřete ho do složených závorek ({}). To je zvlášť důležité, pokud za názvem proměnné následuje dvojtečka (:). PowerShell považuje vše mezi $ specifikátorem oboru a : oborem, což obvykle způsobuje selhání interpretace. Například "$HOME: where the heart is." vyvolá chybu, ale "${HOME}: where the heart is." funguje podle očekávání.

Pokud chcete zabránit nahrazení hodnoty proměnné v řetězci s dvojitým uvozováním, použijte znak zpětného zápisu (`), což je řídicí znak PowerShellu.

V následujícím příkladu znak backtick, který předchází první $i proměnné, zabrání PowerShellu nahradit název proměnné jeho hodnotou. Příklad:

$i = 5
"The value of `$i is $i."

Výstupem tohoto příkazu je:

The value of $i is 5.

Řetězce s jednoduchými uvozovými znaky

Řetězec uzavřený v jednoduchých uvozovkách je doslovný řetězec. Řetězec se předá příkazu přesně tak, jak ho zadáte. Neprovádí se žádná náhrada. Příklad:

$i = 5
'The value of $i is $i.'

Výstupem tohoto příkazu je:

The value $i is $i.

Podobně se nevyhodnocují výrazy v řetězcích s jedním uvozem. Interpretují se jako řetězcové literály. Příklad:

'The value of $(2+3) is 5.'

Výstupem tohoto příkazu je:

The value of $(2+3) is 5.

Zahrnutí znaků uvozovek do řetězce

Pokud chcete, aby se v řetězci zobrazovaly dvojité uvozovky, uzavřete celý řetězec do jednoduchých uvozovek. Příklad:

'As they say, "live and learn."'

Výstupem tohoto příkazu je:

As they say, "live and learn."

Řetězec s jednou uvozovou sadou můžete uzavřít také do řetězce s dvojitou uvozovou sadou. Příklad:

"As they say, 'live and learn.'"

Výstupem tohoto příkazu je:

As they say, 'live and learn.'

Nebo poklikejte uvozovky kolem dvojité uvozovky. Příklad:

"As they say, ""live and learn."""

Výstupem tohoto příkazu je:

As they say, "live and learn."

Pokud chcete do řetězce s jednou uvozovkou zahrnout jednu uvozovku, použijte druhou po sobě jdoucí jednoduchou uvozovku. Příklad:

'don''t'

Výstupem tohoto příkazu je:

don't

Pokud chcete, aby PowerShell interpretovat dvojitou uvozovku doslova, použijte zpětný znak. To zabrání PowerShellu interpretovat uvozovky jako oddělovač řetězců. Příklad:

"Use a quotation mark (`") to begin a string."
'Use a quotation mark (`") to begin a string.'

Vzhledem k tomu, že obsah řetězců s jednoduchými uvozovými znaky se interpretuje doslova, zachází se zpětným znakem jako s literálovým znakem a zobrazí se ve výstupu.

Use a quotation mark (") to begin a string.
Use a quotation mark (`") to begin a string.

Vzhledem k tomu, že PowerShell interpretuje inteligentní uvozovky, jako ‘je , ’, “a ”, jako normální uvozovky, musí být také uvozovky. Příklad:

"Double ““smart quotation marks`” must be escaped in a double-quoted string."
'Single ‘‘smart quotation marks’’ must be escaped in a single-quoted string.'

Double “smart quotation marks” must be escaped in a double-quoted string.
Single ‘smart quotation marks’ must be escaped in a single-quoted string.

Zde uvedené řetězce

Pravidla uvozovekproch

Here-string je řetězec s jednoduchým nebo dvojitým uvozováním obklopený znakem (@). Uvozovky v řetězci se interpretují doslova.

Řetězec se zde:

• spans multiple lines
• začíná levou značkou následovanou novým řádekem.
• končí novým řádekem následovaným pravou značkou.
• zahrnuje každý řádek mezi levou a pravou značkou jako součást jednoho řetězce.

Stejně jako běžné řetězce jsou proměnné nahrazeny jejich hodnotami v dvojitých uvozových řetězcích. V jednoduchých uvozovaných řetězcích se proměnné nenahrazovat jejich hodnotami.

Tady můžete použít řetězce pro libovolný text, ale jsou zvláště užitečné pro následující druhy textu:

• Text obsahující uvozovky literálů
• Více řádků textu, například text v bloku HTML nebo XML
• Text nápovědy pro skript nebo dokument funkce

Zde-řetězec může mít některý z následujících formátů, kde <Enter> představuje skrytý znak řádku nebo nový řádek, který se přidá při stisknutí klávesy ENTER .

Dvojité uvozovky:

@"<Enter>
<string> [string] ...<Enter>
"@

Jednoduché uvozovky:

@'<Enter>
<string> [string] ...<Enter>
'@

Řetězec se zde obsahuje veškerý text mezi levou a pravou značkou. V řetězci se všechny uvozovky interpretují doslova. Příklad:

@"
For help, type "get-help"
"@

Výstupem tohoto příkazu je:

For help, type "get-help"

Použití zde-řetězce může zjednodušit použití řetězce v příkazu. Příklad:

@"
Use a quotation mark, like ' or ", to begin a string.
"@

Výstupem tohoto příkazu je:

Use a quotation mark, like ' or ", to begin a string.

V jednoduchých uvozovaných řetězcích se proměnné interpretují doslova a reprodukují přesně. Příklad:

@'
The $profile variable contains the path
of your PowerShell profile.
'@

Výstupem tohoto příkazu je:

The $profile variable contains the path
of your PowerShell profile.

V dvojitých uvozových řetězcích jsou proměnné nahrazeny jejich hodnotami. Příklad:

@"
Even if you have not created a profile,
the path of the profile file is:
$profile.
"@

Výstupem tohoto příkazu je:

Even if you have not created a profile,
the path of the profile file is:
C:\Users\User1\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1.

Zde-řetězce se obvykle používají k přiřazení více řádků proměnné. Například následující zde-řetězec přiřadí stránku XML $page proměnné.

$page = [XML] @"
<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10"
xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10"
xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">
<command:details>
        <command:name>
               Format-Table
        </command:name>
        <maml:description>
            <maml:para>Formats the output as a table.</maml:para>
        </maml:description>
        <command:verb>format</command:verb>
        <command:noun>table</command:noun>
        <dev:version></dev:version>
</command:details>
...
</command:command>
"@

Tyto řetězce jsou také pohodlným formátem pro vstup do ConvertFrom-StringData rutiny, který převádí řetězce sem na hashovací tabulky. Další informace najdete na webu ConvertFrom-StringData.

Interpretace rozbalitelných řetězců

Rozšířené řetězce nemusí nutně vypadat stejně jako výchozí výstup, který vidíte v konzole.

Kolekce, včetně polí, jsou převedeny na řetězce umístěním jediné mezery mezi řetězcové reprezentace prvků. Jinou oddělovač lze určit nastavením proměnné $OFSpředvoleb . Další informace najdete v $OFS proměnné předvoleb.

Instance jakéhokoli jiného typu jsou převedeny na řetězce voláním ToString() metody, která nemusí dávat smysluplné vyjádření. Příklad:

"hashtable: $(@{ key = 'value' })"

hashtable: System.Collections.Hashtable

Pokud chcete získat stejný výstup jako v konzole, použijte dílčí výraz, ve kterém kanálujete .Out-String Použijte metodu Trim() , pokud chcete odebrat všechny úvodní a koncové prázdné řádky.

"hashtable:`n$((@{ key = 'value' } | Out-String).Trim())"

hashtable:
Name                           Value
----                           -----
key                            value

Nastavení jazykové verze má vliv na interpretaci řetězců

Metody ToString() používají aktuální nakonfigurovaná nastavení jazykové verze k převodu hodnot na řetězce. Například jazyková verze následující relace PowerShellu je nastavená na de-DEhodnotu . ToString() Když metoda převede hodnotu $x na řetězec, použije čárku (,) pro oddělovač desetinných míst. ToString() Metoda také převede datum na řetězec pomocí vhodného formátu pro nastavení německého národního prostředí.

PS> Get-Culture

LCID             Name             DisplayName
----             ----             -----------
1031             de-DE            German (Germany)

PS> $x = 1.2
PS> $x.ToString()
1,2

PS> (Get-Date 2024-03-19).ToString()
19.03.2024 00:00:00

PowerShell však při interpretaci rozbalitelných řetězcových výrazů používá invariantní jazykovou verzi.

PS? "$x"
1.2

PS> "$(Get-Date 2024-03-19)"
03/19/2024 00:00:00

Předávání řetězců s uvozovými znaky externím příkazům

Některé nativní příkazy očekávají argumenty, které obsahují znaky uvozovek. PowerShell interpretuje uvozovaný řetězec před jeho předáním externímu příkazu. Tato interpretace odebere vnější znaky uvozovek.

Další informace o tomto chování najdete v článku about_Parsing .

Viz také

• about_Special_Characters
• ConvertFrom-StringData