Azure CLI için Azure Sphere uzantısına genel bakış
Azure Sphere'a bağlı cihazları ve bulut dağıtımlarını yönetmeye yönelik komut satırı aracı bir Azure CLI uzantısı olarak dağıtılır.
Azure CLI ve Azure Sphere uzantısını yükleme
Azure CLI için Azure Sphere uzantısını almak için:
Henüz yapmadıysanız Azure CLI'yi yükleyin.
Azure Sphere uzantısını eklemek için aşağıdaki komutu çalıştırın:
az extension add --name azure-sphere
Azure Sphere cihazlarını yönetmek için kullanmak istediğiniz Azure aboneliğinde oturum açmak için Azure CLI ile oturum açmanız gerekir.
Bir uzantı yüklendikten sonra, konumu kabuk değişkeninin $AZURE_EXTENSION_DIR değeri altında bulunur. Bu değişken ayarlanmamışsa, varsayılan olarak değer Linux ve macOS'ta ve %USERPROFILE%\.azure\cliextensions Windows'tadır$HOME/.azure/cliextensions.
Ipucu
Oturum açtıktan sonra Azure hesabınızla ilişkili aboneliklerin listesini görürsünüz. Azure Sphere uzantısının düzgün çalışması için komutunu kullanarak az account set gerekli izinlere sahip aboneliği seçtiğinizden emin olun. Abonelik seçimi hakkında daha fazla bilgi için bkz. Birden çok Azure aboneliği kullanma.
Azure Sphere uzantısını yönetme
Azure CLI uzantılarının yüklü sürümlerini görmek için komutunu kullanın:
az version
Azure Sphere uzantısını en son sürüme güncelleştirmek için şunu kullanın:
az extension update --name azure-sphere
Azure Sphere uzantısını kaldırmak için şunları kullanın:
az extension remove --name azure-sphere
Yaygın Azure Sphere CLI komutları
Windows komut isteminden veya PowerShell'den yazarak az sphere Azure Sphere komutlarını kullanabilirsiniz.
Linux'ta herhangi bir komut satırı arabirimini (CLI) kullanabilirsiniz. CLI, bash kabuğu altındaki komutlar için tam sekme tamamlamaya sahiptir.
Bu tabloda bazı yaygın Azure Sphere komutları ve bunların başvuru belgelerine bağlantılar listelenmiştir.
| Komut | Açıklama |
|---|---|
az sphere catalog |
Kataloğunuzu yönetin. |
az sphere ca-certificate |
Kataloğunuzdaki sertifikaları yönetin. |
az sphere deployment |
Kataloğunuzdaki dağıtımları yönetin. |
az sphere device |
Azure Sphere cihazlarını yönetme. |
az sphere device-group |
Kataloğunuzdaki cihaz gruplarını yönetin. |
az sphere image |
Kataloğunuzdaki görüntüleri yönetin. |
az sphere product |
Kataloğunuzdaki ürünleri yönetin. |
az sphere get-support-data |
Sistem, bulut ve cihaz yapılandırmalarınız hakkında tanılama verileri toplayın. |
Azure CLI, , --subscriptionveya --cataloggibi parametreler için varsayılan değerler sağlayarak Azure Sphere CLI komutlarının kullanımını basitleştiren yapılandırma seçeneklerini ayarlamanıza --resource-groupolanak tanır.
Cihaza bağımlı komutlar
Komut, yerel olarak eklenmiş bir Azure Sphere cihazıyla çalışır. Bir cihaz bağlı olmadan komutu denerseniz bir hata alırsınız. Cihaz komutları hakkında daha fazla bilgi için bkz. az sphere device
az sphere device claimaz sphere device recoveraz sphere device restartaz sphere device show-attachedaz sphere device show-os-versionaz sphere device app show-memory-statusaz sphere device app show-quotaaz sphere device app show-statusaz sphere device app startaz sphere device app stopaz sphere device capability show-attachedaz sphere device capability updateaz sphere device certificate addaz sphere device certificate deleteaz sphere device certificate listaz sphere device certificate showaz sphere device certificate show-quotaaz sphere device image list-installedaz sphere image-package showaz sphere device manufacturing-state showaz sphere device manufacturing-state updateaz sphere device network proxy applyaz sphere device network proxy deleteaz sphere device network proxy showaz sphere device network disableaz sphere device network enableaz sphere device network list-firewall-rulesaz sphere device network list-interfacesaz sphere device network show-diagnosticsaz sphere device network show-statusaz sphere device network update-interfaceaz sphere device sideload deleteaz sphere device sideload deployaz sphere device wifi addaz sphere device wifi disableaz sphere device wifi enableaz sphere device wifi forgetaz sphere device wifi listaz sphere device wifi reload-configaz sphere device wifi scanaz sphere device wifi showaz sphere device wifi show-status
Genel olarak kullanılabilir bağımsız değişkenler
Azure Sphere uzantısı için aşağıdaki genel parametreler kullanılabilir:
| Parametre | Açıklama |
|---|---|
--debug |
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın. |
--help -h |
Yardım iletisini gösterir. |
--only-show-errors |
Yalnızca hataları gösterir ve uyarıları gizler. |
--output -o |
Çıkış biçimi. İzin verilen değerler: json, jsonc, none, table, , tsv, yaml. yamlc Varsayılan: json. |
--query |
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ . |
--subscription |
: Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz. |
--verbose |
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için kullanın --debug . |