Kiracı

Bir Azure Sphere kiracısı yönetir.

Önemli

, azsphere tenant download-ca-certificate-chainve azsphere tenant download-validation-certificate komutları azsphere tenant download-ca-certificateeskidir. Bunun yerine , azsphere ca-certificate download-chain, azsphere ca-certificate download-proofve azsphere ca-certificate list kullanınazsphere ca-certificate download.

Azure Sphere CLI'da, bir kiracı oluşturulduğunda varsayılan kiracı otomatik olarak seçilmez. Bilgisayarda 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.

Işlem	Açıklama
Oluşturmak	Yeni bir kiracı oluşturur.
download-error-report	Geçerli kiracıdaki cihazlar için hata bilgilerini döndürür.
Liste	Kullanılabilir Azure Sphere kiracılarını listeler.
Seçin	Bu bilgisayarda kullanılacak varsayılan Azure Sphere kiracısını seçer.
show-selected	Bu bilgisayar için varsayılan Azure Sphere kiracısını gösterir.
Güncelleştirme	Kiracının adını gibi kiracının ayrıntılarını Güncelleştirmeler.

Oluşturmak

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 bilgisayarda 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	Dize	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	Dize	Birden çok cihaz eklendiğinde komutun çalıştırıldığı cihazı belirtir. Birden çok cihaz eklendiğinde bu parametre gereklidir. Şu anda bağlı olan cihaz varsayılan olarak kullanılır. Bağlı 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ük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug 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. CLI varsayılan olarak çıkışlarıdır table. 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. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Ö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.

Ipucu

Bir kiracı oluşturduktan sonra azsphere tenant select komutunu çalıştırarak bu bilgisayarda 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ı içindeki 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	Dize	Çıkış dosyasının yolunu ve dosya adını belirtir.
-t, --tenant	GUID veya ad	Bu işlemi gerçekleştirecek 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ük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug 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. CLI varsayılan olarak çıkışlarıdır table. 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. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Örnek

azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

Liste

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ük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug 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. CLI varsayılan olarak çıkışlarıdır table. 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. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Örnek

azsphere tenant list
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant              Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

Seçin

Bu bilgisayarda 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ştirecek 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ük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug 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. CLI varsayılan olarak çıkışlarıdır table. 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. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Örnek

azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

show-selected

Bu bilgisayarda 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ük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug 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. CLI varsayılan olarak çıkışlarıdır table. 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. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Örnek

azsphere tenant show-selected
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

Güncelleştirme

Kiracının adını gibi bir kiracının ayrıntılarını Güncelleştirmeler.

Gerekli parametreler

Parametre	Türü	Açıklama
-n, --new-name	Dize	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ştirecek 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ük ayrıntı düzeyini artırır. Bir hata bulursanız, hata raporu gönderirken bayrağıyla --debug 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. CLI varsayılan olarak çıkışlarıdır table. 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. Tam hata ayıklama günlükleri için kullanın --debug .

Not

Azure Sphere klasik CLI kullanıyorsanız, kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. Genel parametreler .

Örnek

azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2               Administrator
                                                            Contributor
 ------------------------------------ --------------------- -------------

Ipucu

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.