Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Önemli
Bu, Azure Sphere (Eski) belgeleridir. Azure Sphere (Eski) 27 Eylül 2027'de kullanımdan kaldırılıyor ve kullanıcıların bu zamana kadar Azure Sphere'e (Tümleşik) geçmeleri gerekiyor. Azure Sphere (Tümleşik) belgelerini görüntülemek için İçindekiler tablosu üzerinde bulunan Sürüm seçiciyi kullanın.
Bir Azure Sphere kiracısı yönetir.
Önemli
, azsphere tenant download-ca-certificateve azsphere tenant download-ca-certificate-chain komutları azsphere tenant download-validation-certificateeskidir. Bunun yerine , azsphere ca-certificate download, azsphere ca-certificate download-chainve azsphere ca-certificate download-proof kullanınazsphere ca-certificate list.
Azure Sphere CLI'da, bir kiracı oluşturulduğunda varsayılan kiracı otomatik olarak seçilmez. Bilgisayardaki geçerli kullanıcı için kullanılacak varsayılan kiracıyı seçmek için azsphere tenant select komutunu çalıştırmanız gerekir. Bu, varsayılan kiracının, cihazı talep etme gibi geri alamayacağınız tek seferlik bir işlem gerçekleştirirken kullanılacak doğru kiracı olduğundan emin olmaktır.
| Operasyon | Açıklama |
|---|---|
| oluşturmaya | Yeni bir kiracı oluşturur. |
| download-error-report | Geçerli kiracıdaki cihazlar için hata bilgilerini döndürür. |
| listele | Kullanılabilir Azure Sphere kiracılarını listeler. |
| seçmek | Bu bilgisayarda kullanılacak varsayılan Azure Sphere kiracısını seçer. |
| seçili göster | Bu bilgisayar için varsayılan Azure Sphere kiracısını gösterir. |
| update | Kiracının adı gibi kiracının ayrıntılarını güncelleştirir. |
oluşturmaya
Yeni bir Azure Sphere kiracısı oluşturur. Bu komutu çalıştırmak için ekli bir cihaz gereklidir. Daha fazla bilgi için bkz . Azure Sphere kiracısı oluşturma.
Zaten bir kiracınız varsa ve başka bir kiracı istediğinizden eminseniz parametresini --force-additional kullanın. Şu anda bir Azure Sphere kiracısı silemezsiniz.
Kiracı oluşturulduktan sonra azsphere tenant select komutunu çalıştırarak bu bilgisayardaki geçerli kullanıcı için kullanılacak varsayılan kiracıyı seçin. azsphere role add komutunu kullanarak geçerli Azure Sphere kiracısındaki kullanıcılar için roller ekleyebilirsiniz .
azsphere tenant create komutu, yerel olarak eklenmiş bir Azure Sphere cihazıyla çalışır. Bir cihaz bağlı olmadan komutu denerseniz bir hata alırsınız. Bir kiracı oluşturduğunuzda cihaz kimliği kaydedilir ve cihaz başına yalnızca bir kiracı oluşturulabilir.
Gerekli parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| -n, --name | String | Kiracı için bir ad belirtir. Kiracınızı adlandırırken alfasayısal karakterler kullanın. Özel karakterlere izin verilmez. Ad 50 karakteri aşmamalıdır ve büyük/küçük harfe duyarlıdır. |
İsteğe bağlı parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| -d, --device | String | Birden çok cihaz eklendiğinde komutun çalıştırıldığı cihazı belirtir. Bu parametre, birden çok cihaz eklendiğinde gereklidir. Şu anda bağlı olan cihaz varsayılan olarak kullanılır. Ekli cihazın cihaz kimliğini, IP adresini veya Yerel Bağlantı Kimliğini belirtebilirsiniz. Azure Sphere CLI, Windows üzerinde birden çok MT3620 cihazını destekler, ancak Linux'ta aynı anda yalnızca bir cihaz bağlayabilirsiniz. Bu nedenle bu parametre Windows için desteklenir ancak Linux için desteklenmez. Bu parametreyi Linux'ta komutuyla kullanırsanız bir hata döndürülür. |
| --force-additional | Boolean | Yeni bir Azure Sphere kiracısı oluşturmaya zorlar. Bu komutu yalnızca, bağlı cihazı kullanarak yeni bir Azure Sphere kiracısı oluşturmak için geçerli hesabı kullanmak istediğinizden eminseniz kullanın. |
| --disable-confirm-prompt | Boolean | Kullanıcı onay istemini devre dışı bırakır. |
Genel parametreler
Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:
| Parametre | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlüğe kaydetme ayrıntı düzeyini artırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın. |
| -h, --help | Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler. |
| --only-show-errors | Yalnızca hataları gösterir ve uyarıları gizler. |
| -o, --output | Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. Varsayılan olarak CLI, table çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure Sphere CLI komutları için çıkış biçimi. |
| --sorgu | Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz . JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama. |
| --Ayrıntılı | Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Eksiksiz hata ayıklama günlükleri için --debug kullanın. |
Örnek
azsphere tenant create --name MyTenant
--force-additional Ekli cihazı kullanarak yeni bir Azure Sphere kiracısı oluşturmak için bu hesabı kullanmak istediğinizden eminseniz ve --disable-confirm-prompt parametrelerini kullanın. Daha önce Azure Sphere kiracısı oluşturmak için kullanılan bir cihaz, yeni bir kiracı oluşturmak için kullanılamaz.
azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
--> Tenant Name: MyTenant1
--> Tenant ID: 768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.
İpucu
Bir kiracı oluşturduktan sonra azsphere tenant select komutunu çalıştırarak bu bilgisayardaki geçerli kullanıcı için kullanılacak varsayılan kiracıyı seçtiğinizden emin olun.
download-error-report
Geçerli kiracıdaki cihazlar tarafından bildirilen hatalara ilişkin bilgileri döndürür.
Bu komut, Azure Sphere Güvenlik Hizmeti bulutundan olay verilerini çeker ve belirli bir cihaza fiziksel bağlantı gerektirmez. azsphere tenant download-error-report komutu geçerli kiracı bağlamında çalışır ve bu kiracıdaki tüm cihazlar için hata raporları döndürür.
Not
Yakın zamanda bildirilen olayların indirilmesi 24 saat kadar sürebilir. Daha fazla bilgi için bkz . Hata verilerini toplama ve yorumlama.
İsteğe bağlı parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| --hedef | String | Çıkış dosyasının yolunu ve dosya adını belirtir. |
| -t, --tenant | GUID veya ad | Bu işlemi gerçekleştirmek için kiracıyı belirtir. Varsayılan seçili kiracıyı geçersiz kılar. Kiracı kimliğini veya kiracı adını belirtebilirsiniz. |
Genel parametreler
Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:
| Parametre | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlüğe kaydetme ayrıntı düzeyini artırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın. |
| -h, --help | Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler. |
| --only-show-errors | Yalnızca hataları gösterir ve uyarıları gizler. |
| -o, --output | Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. Varsayılan olarak CLI, table çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure Sphere CLI komutları için çıkış biçimi. |
| --sorgu | Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz . JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama. |
| --Ayrıntılı | Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Eksiksiz hata ayıklama günlükleri için --debug kullanın. |
Örnek
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
listele
Azure Sphere kiracılarını listeler.
Genel parametreler
Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:
| Parametre | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlüğe kaydetme ayrıntı düzeyini artırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın. |
| -h, --help | Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler. |
| --only-show-errors | Yalnızca hataları gösterir ve uyarıları gizler. |
| -o, --output | Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. Varsayılan olarak CLI, table çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure Sphere CLI komutları için çıkış biçimi. |
| --sorgu | Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz . JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama. |
| --Ayrıntılı | Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Eksiksiz hata ayıklama günlükleri için --debug kullanın. |
Örnek
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
select
Bu bilgisayardaki geçerli kullanıcı için kullanılacak varsayılan Azure Sphere kiracısını seçer.
Geçerli varsayılan kiracıyı görüntülemek için azsphere tenant show-selected kullanın.
Gerekli parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| -t, --tenant | GUID veya ad | Bu işlemi gerçekleştirmek için kiracıyı belirtir. Varsayılan seçili kiracıyı geçersiz kılar. Kiracı kimliğini veya kiracı adını belirtebilirsiniz. |
Genel parametreler
Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:
| Parametre | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlüğe kaydetme ayrıntı düzeyini artırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın. |
| -h, --help | Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler. |
| --only-show-errors | Yalnızca hataları gösterir ve uyarıları gizler. |
| -o, --output | Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. Varsayılan olarak CLI, table çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure Sphere CLI komutları için çıkış biçimi. |
| --sorgu | Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz . JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama. |
| --Ayrıntılı | Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Eksiksiz hata ayıklama günlükleri için --debug kullanın. |
Örnek
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
seçili göster
Bu bilgisayardaki geçerli kullanıcı için varsayılan Azure Sphere kiracısının ayrıntılarını görüntüler.
Bu, azsphere tenant select komutuyla seçilen kiracıdır.
Genel parametreler
Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:
| Parametre | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlüğe kaydetme ayrıntı düzeyini artırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın. |
| -h, --help | Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler. |
| --only-show-errors | Yalnızca hataları gösterir ve uyarıları gizler. |
| -o, --output | Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. Varsayılan olarak CLI, table çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure Sphere CLI komutları için çıkış biçimi. |
| --sorgu | Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz . JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama. |
| --Ayrıntılı | Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Eksiksiz hata ayıklama günlükleri için --debug kullanın. |
Örnek
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
update
Kiracının adı gibi kiracının ayrıntılarını güncelleştirir.
Gerekli parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| -n, --new-name | String | Kiracı için yeni bir ad belirtir. Kiracınızı adlandırırken alfasayısal karakterler kullanın. Özel karakterlere izin verilmez. Ad 50 karakteri aşmamalıdır ve büyük/küçük harfe duyarlıdır. |
İsteğe bağlı parametreler
| Parametre | Tür | Açıklama |
|---|---|---|
| -t, --tenant | GUID veya ad | Bu işlemi gerçekleştirmek için kiracıyı belirtir. Varsayılan seçili kiracıyı geçersiz kılar. Kiracı kimliğini veya kiracı adını belirtebilirsiniz. |
Genel parametreler
Azure Sphere CLI için aşağıdaki genel parametreler kullanılabilir:
| Parametre | Açıklama |
|---|---|
| --hata ayıklama | Tüm hata ayıklama günlüklerini göstermek için günlüğe kaydetme ayrıntı düzeyini artırır. Hata bulursanız, hata raporu gönderirken --debug bayrağı ile oluşturulan çıkışı sağlayın. |
| -h, --help | Komutlar ve bağımsız değişkenleri hakkındaki CLI başvuru bilgilerini yazdırır ve kullanılabilir alt grupları ve komutları listeler. |
| --only-show-errors | Yalnızca hataları gösterir ve uyarıları gizler. |
| -o, --output | Çıkış biçimini değiştirir. Kullanılabilir çıkış biçimleri json, jsonc (renklendirilmiş JSON), tsv (Sekmeyle Ayrılmış Değerler), tablo (insan tarafından okunabilir ASCII tabloları) ve yaml'dir. Varsayılan olarak CLI, table çıkışı sağlar. Kullanılabilir çıkış biçimleri hakkında daha fazla bilgi edinmek için bkz . Azure Sphere CLI komutları için çıkış biçimi. |
| --sorgu | Azure Sphere Güvenlik Hizmetleri'nden döndürülen çıkışı filtrelemek için JMESPath sorgu dilini kullanır. Daha fazla bilgi ve örnek için bkz . JMESPath öğreticisi ve Azure CLI komut çıktısını sorgulama. |
| --Ayrıntılı | Bir işlem sırasında Azure Sphere'da oluşturulan kaynaklar hakkındaki bilgileri ve diğer yararlı bilgileri yazdırır. Eksiksiz hata ayıklama günlükleri için --debug kullanın. |
Örnek
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
İpucu
Varsayılan bir kiracı seçmediyseniz, kullanılabilir kiracıların listesi görüntülenir. Seçeneklerden birini belirleyerek varsayılan kiracınızı ayarlayın.