Jak pracować z parametrami globalnymi w interfejsie wiersza polecenia platformy Azure
Podczas pracy z poleceniami referencyjnymi interfejsu wiersza polecenia platformy Azure istnieją argumenty, które są dostępne dla większości poleceń. Te argumenty są nazywane "parametrami globalnymi", ponieważ są one wspólne dla prawie wszystkich poleceń referencyjnych interfejsu wiersza polecenia platformy Azure.
--help parametr globalny
Aby uzyskać informacje o grupie referencyjnej lub poleceniu, użyj parametru globalnego --help . Parametr --help wyświetla informacje referencyjne interfejsu wiersza polecenia platformy Azure w konsoli, w tym listę dostępnych podgrup i parametrów.
az group create --name myResourceGroup --location eastus --help
Następujące dane wyjściowe konsoli pokazane tutaj zawierają pola pominięte w celu zwięzłości:
Command
az group create : Create a new resource group.
Arguments
--location -l [Required] : Location. Values from: `az account list-locations`.
You can configure the default location using `az
configure --defaults location=<location>`.
--name --resource-group -g -n [Required] : Name of the new resource group.
--managed-by : The ID of the resource that manages this resource
group.
--tags : Space-separated tags: key[=value] [key[=value] ...].
Use "" to clear existing tags.
Global Arguments
--debug : Increase logging verbosity to show all debug logs.
--help -h : Show this help message and exit.
--only-show-errors : Only show errors, suppressing warnings.
Examples
Create a new resource group in the West US region.
az group create -l westus -n MyResourceGroup
--verbose parametr globalny
Dowiedz się więcej szczegółowych informacji na temat rejestrowania, dodając parametr globalny do polecenia referencyjnego --verbose . Pełne dane wyjściowe są przydatne podczas próby zrozumienia, dlaczego wykonywanie niektórych poleceń trwa dłużej niż inne.
az group create --name myResourceGroup --location eastus --verbose
Poniższe dane wyjściowe konsoli pokazane tutaj zawierają pola pominięte w celu zwięzłości, ale zwróć uwagę na dodatkowe informacje dotyczące czasu wykonywania.
{...}
Command ran in 1.413 seconds (init: 0.487, invoke: 0.926)
--debug parametr globalny
Jeśli dodatkowe szczegóły z parametru --verbose nie są wystarczające i chcesz wyświetlić cały dziennik, użyj parametru globalnego --debug . Podaj również dane wyjściowe wygenerowane za pomocą --debug polecenia podczas przesyłania raportu o usterce.
az group create --name myrResourceGroup --location eastus --debug
Następujące dane wyjściowe konsoli pokazane tutaj zawierają pola pominięte w celu zwięzłości:
cli.knack.cli: Command arguments: ['group', 'create', '--name', 'myResourceGroup', '--location', 'eastus', '--debug']
cli.knack.cli: __init__ debug log:
[...]
cli.knack.cli: Event: CommandInvoker.OnTransformResult [<function _resource_group_transform at 0x000001D9B72123B0>, <function _x509_from_base64_to_hex_transform at 0x000001D9B7212440>]
cli.knack.cli: Event: CommandInvoker.OnFilterResult []
{...}
[...]
telemetry.process: Return from creating process
telemetry.main: Finish creating telemetry upload process.
--only-show-errors parametr globalny
Podczas debugowania usuń ostrzeżenia zwrócone przez polecenie referencyjne przy użyciu parametru globalnego --only-show-errors .
az interactive
Konsola wyjściowa:
**This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus**
Any comments or concerns? You can use the 'feedback' command! We would greatly appreciate it.
A new Recommender is added which can make the completion ability more intelligent and provide the scenario completion!
If you want to disable this feature, you can use 'az config set interactive.enable_recommender=False' to disable it.
A command preload mechanism was added to prevent lagging and command run errors.
You can skip preloading in a single pass by CTRL+C or turn it off by setting 'az config set interactive.enable_preloading=False'
Loading command table... Expected time around 1 minute.
--subscription parametr globalny
Możesz użyć parametru globalnego --subscription , aby ustawić określoną subskrypcję dla polecenia. Poniższy przykład zmienia aktywną subskrypcję przy użyciu identyfikatora subskrypcji:
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
--output parametr globalny
Aby wyświetlić dane wyjściowe polecenia w określonym formacie, określ --output parametr globalny. W tym przykładzie dane wyjściowe są wyświetlane jako tabela:
Uwaga
Akceptowane wartości danych wyjściowych to: json, jsonc, none, table, tsv, yaml i yamlc. Domyślna wartość wyjściowa to json.
az vm list --resource-group myResourceGroup --output table
Konsola wyjściowa:
Name ResourceGroup Location
------ --------------- ----------
myVm myResourceGroup eastus
Aby dowiedzieć się więcej o różnych formatach danych wyjściowych, zobacz Formaty danych wyjściowych dla poleceń interfejsu wiersza polecenia platformy Azure.
--query parametr globalny
Czasami konsola danych wyjściowych może wyświetlać obszerne ilości informacji, które należy przefiltrować. W tym celu użyj parametru globalnego --query , aby wykonać zapytanie JMESPath na wynikach poleceń. JMESPath to język zapytań dla formatu JSON, który umożliwia wybieranie i modyfikowanie danych z danych wyjściowych interfejsu wiersza polecenia platformy Azure.
W tym przykładzie zwracane są klucze publiczne SSH autoryzowane do nawiązywania połączenia z maszyną wirtualną przez dodanie polecenia --query:
az vm show --resource-group myResourceGroup --name myVm --query "osProfile.linuxConfigurat
ion.ssh.publicKeys"
Konsola wyjściowa:
[
{
"keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7WbiMEsB0iwdGPjeGXs3UWFtzbCkUwtIxzkIOpEtlqkLGa0XQdvwhzok6szq6Ycx/f4cfid/yrmBPtzmxdQnGeCy2FOcVIzp+SkjIUg/Ez2YyDcMb60u66QUmHPRyhipJ/PDZROt6O0092qfTkTjB+7hLRiZzV2raLjiQ95eV0AXUP+Gsvdo/7ytqWNIm3iQTWbQ/GwSg+p0v+kmZELIbrxo845dambSpgBL8g0wCUZaptru3ZHo9m0UWbFPASVJKauhfPCSVPQCaOCaAdB01Ih8QDVRCazT+jyV6GgTwUIXVQthVBbt56ibhuSUdf0cWF8IVncjH+WXexVAhQw0j",
"path": "/home/yourName/.ssh/authorized_keys"
}
]
Aby dowiedzieć się więcej na temat wykonywania zapytań dotyczących danych wyjściowych polecenia, zobacz Jak wykonywać zapytania względem danych wyjściowych polecenia interfejsu wiersza polecenia platformy Azure przy użyciu zapytania JMESPath.
