引用文本語言之間的差異
當您使用 Azure CLI 命令時，請注意文稿語言如何使用引號和逸出字元。 如果您支援不同殼層中使用的腳本，瞭解引用差異可節省寶貴的開發時間。
若要使用包含單引號或雙引號或逸出字元的參數值來避免非預期的結果，以下是一些建議：
空格元和引號
如果您提供包含空格符的參數值，請以引弧括住值。
在Bash和PowerShell中，如果您的變數值包含單引號，請以雙引號括住值，反之亦然。
在Bash中，逸出的雙引號會被視為字串的一部分。
在 Windows 命令提示字元中，變數值內的引號會視為值的一部分。
以下是一些範例：
# Correct
myVariable="my string ' ' wrapped in double quotes"
myVariable='my string " " wrapped in single quotes'
myVariable="my string with escaped \" \" double quotes wrapped in double quotes"
# Wrong, escaped single quotes in Bash are not treated as part of the string
myVariable='my value with escaped \' \' single quotes wrapped in single quotes'
# after each example ...
echo $myVariable
正確範例的 Bash 輸出如下所示：
my string ' ' wrapped in double quotes
my string " " wrapped in single quotes
my string with escaped " " double quotes wrapped in double quotes
如果您想要輸出中包含的引號，請逸出變數，如下所示： echo \"$myVariable\"。
echo \"$myVariable\"
"my string ' ' wrapped in double quotes"
echo \'$myVariable\'
'my string " " wrapped in single quotes'
echo \"$myVariable\"
"my string with escaped " " double quotes wrapped in double quotes"
JSON 字串
使用單引號來保留 JSON 字串內的內容。 提供內嵌 JSON 值時，需要單引號。 例如，Bash 和 PowerShell 中的這個 JSON 正確：
'{"key": "value"}'。如果您的命令在 Windows 命令提示字元中執行，您必須使用雙引號。 Cmd.exe 中上述 JSON 字串的對等專案是
"{"key":"value"}"。如果 JSON 值包含雙引號，您必須逸出它們。
使用 JSON 參數值時，請考慮使用 Azure CLI 的
@<file>慣例，並略過殼層的解譯機制。az ad app create --display-name myName --native-app --required-resource-accesses @manifest.json
以下是 Bash、PowerShell 和 Cmd 可接受的 JSON 格式模式：
使用 Bash 的 clear 命令來移除測試之間的控制台輸出。
# Correct in Bash
az '{"key":"value"}' --debug
>> Command arguments: ['{"key":"value"}', '--debug']
az "{\"key\":\"value\"}" --debug
>> Command arguments: ['{"key":"value"}', '--debug']
接下來的兩個範例不正確，因為Bash會解譯引號和空格。
| 格式不正確 | 問題 | 主控台輸出 |
|---|---|---|
| az {“key”：“value”} --debug | 遺漏單引號或逸出字元 | 命令自變數：['{key：value}'， '--debug'] |
| az {“key”： “value”} --debug | 遺漏單引號或逸出字元，並包含額外的空格 | 命令自變數：['{key：'， 'value}'， '--debug'] |
空字串
在 PowerShell 中，如果您的值是空引號字串串 （
''），請使用'""'。在 Bash 或 PowerShell 中，如果您的值是空引號字串 （
''），請使用"''"。# Correct in Bash myVariable="''" # Correct in PowerShell $myVariable = "''" $myVariable = '""'
空格分隔值
某些 Azure CLI 命令會採用空格分隔值的清單。 如果索引鍵名稱或值包含空格，請包裝整個配對： "my key=my value"。 例如：
az web app config app settings set --resource-group myResourceGroup --name myWebAppName --settings "client id=id1" "my name=john"
當 CLI 參數指出它接受以空白分隔的清單時，預期有兩種格式之一：
未加上批注、以空白分隔的清單範例：
--parameterName firstValue secondValue以引號分隔的清單範例：
--parameterName "firstValue" "secondValue"
此範例是字串，其中包含一個空格。 它不是以空格分隔的清單: --parameterName "firstValue secondValue"
特殊字元
PowerShell 文稿語言中有特殊字元，例如 在 @。 若要在PowerShell中執行 Azure CLI，請在特殊字元之前新增 ` 以逸出它。 您也可以以單引號或雙引號 "/"括住值。
# The following three examples will work in PowerShell
--parameterName `@parameters.json
--parameterName '@parameters.json'
--parameterName "@parameters.json"
# This example will not work in PowerShell
--parameterName @parameters.json
連字元字元
如果參數的值以連字元開頭，Azure CLI 會嘗試將它剖析為參數名稱。 若要將它剖析為值，請使用 = 來串連參數名稱和值： --password="-VerySecret"。
參數--query
當您搭配--query命令使用 參數時，必須在殼層中逸出 JMESPath 的某些字元。
這三個命令在Bash中是正確的和對等的：
az version --query '"azure-cli"'
az version --query \"azure-cli\"
az version --query "\"azure-cli\""
以下是 Bash 中不正確命令的兩個範例：
# Wrong, as the dash needs to be quoted in a JMESPath query
az version --query azure-cli
az version: error: argument --query: invalid jmespath_type value: 'azure-cli'
# Wrong, as the dash needs to be quoted in a JMESPath query, but quotes are interpreted by Bash
az version --query "azure-cli"
az version: error: argument --query: invalid jmespath_type value: 'azure-cli'
如需 Bash、PowerShell 和 Cmd 之間的更多範例比較，請參閱 查詢 Azure CLI 命令輸出。
參數--debug
對引用問題進行疑難解答的最佳方式是使用 --debug 旗標執行 命令。 此旗標會顯示 Azure CLI 在 Python 語法中收到的實際自變數。
如需使用 針對 Azure CLI 命令 --debug進行疑難解答的詳細資訊，請參閱 針對 Azure CLI 進行疑難解答。
腳本語言規則
以下是其個別組織所發佈的文本語言規則快速連結：
- Bash 腳本語言： Bash 引用規則
- PowerShell 腳本語言： PowerShell 報價規則
- Windows 命令提示字元： 操作說明：Windows 命令行上的逸出字元、分隔符和引號
注意
由於 PowerShell 中的已知問題，因此會套用一些額外的逸出規則。 如需詳細資訊，請參閱 使用 PowerShell 腳本語言執行 Azure CLI 的考慮。
另請參閱
在這些文章中尋找更多文稿語言比較：
