az iot dps enrollment
Not
Bu başvuru, Azure CLI (sürüm 2.46.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, az iot dps enrollment komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek tek cihaz kayıtlarını yönetin.
Komutlar
Name | Description | Tür | Durum |
---|---|---|---|
az iot dps enrollment create |
Azure IoT Hub Cihazı Sağlama Hizmeti'nde tek bir cihaz kaydı oluşturun. |
Dahili | GA |
az iot dps enrollment delete |
Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki tek bir cihaz kaydını silin. |
Dahili | GA |
az iot dps enrollment list |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek tek cihaz kayıtlarını listeleme. |
Dahili | GA |
az iot dps enrollment registration |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde bireysel kayıt için hizmet tarafı cihaz kayıtlarını yönetin. |
Dahili | GA |
az iot dps enrollment registration delete |
Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki tek bir kayıt için cihaz kaydını silin. |
Dahili | GA |
az iot dps enrollment registration show |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde bireysel kayıt için cihaz kaydı alma. |
Dahili | GA |
az iot dps enrollment show |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek tek cihaz kayıt ayrıntılarını alın. |
Dahili | GA |
az iot dps enrollment update |
Azure IoT Hub Cihazı Sağlama Hizmeti'nde tek bir cihaz kaydını güncelleştirme. |
Dahili | GA |
az iot dps enrollment create
Azure IoT Hub Cihazı Sağlama Hizmeti'nde tek bir cihaz kaydı oluşturun.
Lütfen Base64 ASCII kodlamasını kullanarak sertifika biçimini sağlayın ve sertifikanın eşleşen BEGIN ve END segmentlerine sahip olması gerekir; örneğin: '-----BEGIN CERTIFICATE-----' ile başlayın ve '-----END CERTIFICATE-----' ile sonlandırın.
az iot dps enrollment create --at {symmetricKey, tpm, x509}
--eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--certificate-path]
[--device-id]
[--device-information]
[--dps-name]
[--edge-enabled {false, true}]
[--ek]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scp]
[--secondary-key]
[--webhook-url]
Örnekler
'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama Hizmeti'nde kanıtlama türü 'x509' olan ve sağlama durumu 'devre dışı' olan bir '{enrollment_id}' kaydı oluşturun, '{device_id}' cihaz kimliği, ilk ikiz özellikleri '{"location":{"region":"US"}}', ilk ikiz etiketleri '{"version":"1"}', ve cihaz bilgileri '{"color":"red"}'.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type x509 --certificate-path /certificates/Certificate.pem --provisioning-status disabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version':'1'}" --device-info "{'color':'red'}" --device-id {device_id}
'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama Hizmeti'nde kanıtlama türü 'tpm' olan bir 'MyEnrollment' kaydı oluşturun.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89
'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama hizmetinde kanıtlama türü 'simetrik anahtar' olan bir 'MyEnrollment' kaydı oluşturun.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --primary-key {primary_key} --secondary-key {secondary_key}
'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama hizmetinde yeniden sağlama ile 'MyEnrollment' kaydı oluşturun.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --reprovision-policy {reprovision_type} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89
'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama hizmetinde statik ayırma ilkesiyle 'MyEnrollment' kaydı oluşturun.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy static --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs {iot_hub_host_name}
'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama hizmetinde karma ayırma ilkesi ve birden çok hub ile 'MyEnrollment' kaydı oluşturun.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy hashed --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs {iot_hub_host_name1} {iot_hub_host_name2}
Özel ayırma ilkesiyle 'MyEnrollment' kaydı oluşturun,
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}
Gerekli Parametreler
DPS'de kimlik doğrulaması için kullanılan kanıtlama Mekanizması.
Tek tek cihaz kayıt kimliği.
İsteğe Bağlı Parametreler
Bir cihazın IoT Hub'a nasıl atandığını belirlemek için ayırma ilkesi türü. Sağlanmadıysa, ayırma ilkesi Cihaz Sağlama Hizmeti örneği için varsayılan olarak ayarlanan geçerli ayırma ilkesi olacaktır.
Özel ayırma isteğinde gönderilen sağlama hizmeti türlerinin API sürümü. Desteklenen en düşük sürüm: 2018-09-01-preview.
İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iotdps-data-auth-type=<auth-type-value>
yapılandırabilirsiniz.
Birincil sertifikayı içeren dosyanın yolu. Kanıtlama türü olarak x509 seçilirken gereklidir ve ikincil sertifika yolu sağlanmaz.
IoT Hub'a kayıtlı cihaz kimliği.
İsteğe bağlı cihaz bilgileri.
Azure IoT Hub Cihazı Sağlama Hizmeti'nin adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
Kenar etkinleştirmeyi gösteren bayrak.
BIR TPM cihazı için TPM onay anahtarı. Kanıtlama türü olarak tpm'yi seçerken onay anahtarı gereklidir.
Ayırma ilkesiyle ilişkili hedef IoT Hub'ının ana bilgisayar adı. Birden çok IoT Hub'ı için boşlukla ayrılmış liste kullanın.
İlk cihaz ikizi özellikleri.
İlk cihaz ikizi etiketleri.
Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --dps-name sağlanmadıysa gereklidir.
base64 biçiminde depolanan birincil simetrik paylaşılan erişim anahtarı.
Kayıt girdisini etkinleştirin veya devre dışı bırakın.
Farklı bir IoT Hub'a yeniden sağlamada cihaz verilerinin nasıl işlenmesi gerektiğini belirleyen ilke.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İkincil sertifikayı içeren dosyanın yolu. Kanıtlama türü olarak x509 seçilirken gereklidir ve birincil sertifika yolu sağlanmaz.
base64 biçiminde depolanan ikincil simetrik paylaşılan erişim anahtarı.
Özel ayırma istekleri için kullanılan Azure İşlevi web kancası URL'si.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az iot dps enrollment delete
Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki tek bir cihaz kaydını silin.
az iot dps enrollment delete --eid
[--auth-type {key, login}]
[--dps-name]
[--etag]
[--login]
[--resource-group]
Gerekli Parametreler
Tek tek cihaz kayıt kimliği.
İsteğe Bağlı Parametreler
İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iotdps-data-auth-type=<auth-type-value>
yapılandırabilirsiniz.
Azure IoT Hub Cihazı Sağlama Hizmeti'nin adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' değeri kullanılır.
Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --dps-name sağlanmadıysa gereklidir.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az iot dps enrollment list
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek tek cihaz kayıtlarını listeleme.
az iot dps enrollment list [--auth-type {key, login}]
[--dps-name]
[--login]
[--resource-group]
[--top]
İsteğe Bağlı Parametreler
İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iotdps-data-auth-type=<auth-type-value>
yapılandırabilirsiniz.
Azure IoT Hub Cihazı Sağlama Hizmeti'nin adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --dps-name sağlanmadıysa gereklidir.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Döndürülecek öğe sayısı üst sınırı. Sınırsız için -1 kullanın.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az iot dps enrollment show
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek tek cihaz kayıt ayrıntılarını alın.
az iot dps enrollment show --eid
[--auth-type {key, login}]
[--dps-name]
[--keys {false, true}]
[--login]
[--resource-group]
Örnekler
Temel kullanım
az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}
Simetrik anahtar kaydı için sonuçlara tam kanıtlama bilgileri ekleme
az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys
Gerekli Parametreler
Tek tek cihaz kayıt kimliği.
İsteğe Bağlı Parametreler
İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iotdps-data-auth-type=<auth-type-value>
yapılandırabilirsiniz.
Azure IoT Hub Cihazı Sağlama Hizmeti'nin adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
Kayıt sonuçlarına kanıtlama anahtarlarını ve bilgilerini ekleyin.
Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --dps-name sağlanmadıysa gereklidir.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az iot dps enrollment update
Azure IoT Hub Cihazı Sağlama Hizmeti'nde tek bir cihaz kaydını güncelleştirme.
Lütfen Base64 ASCII kodlamasını kullanarak sertifika biçimini sağlayın ve sertifikanın eşleşen BEGIN ve END segmentlerine sahip olması gerekir; örneğin: '-----BEGIN CERTIFICATE-----' ile başlayın ve '-----END CERTIFICATE-----' ile sonlandırın.
az iot dps enrollment update --eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--certificate-path]
[--device-id]
[--device-information]
[--dps-name]
[--edge-enabled {false, true}]
[--ek]
[--etag]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--rc {false, true}]
[--remove-secondary-certificate {false, true}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scp]
[--secondary-key]
[--webhook-url]
Örnekler
'{enrollment_id}' kaydını '{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama Hizmeti'nde yeni bir x509 sertifikasıyla güncelleştirin.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --etag AAAAAAAAAAA=
'{enrollment_id}' kaydını '{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama Hizmeti'nde yeni bir onay anahtarıyla güncelleştirin.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --etag AAAAAAAAAAA=
'{enrollment_id}' kaydını '{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama Hizmeti'nde yeni bir birincil anahtarla güncelleştirin.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=
'{enrollment_id}' kaydını '{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama Hizmeti'nde yeni bir yeniden sağlama türüyle güncelleştirin.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --reprovision-policy {reprovision_type} --etag AAAAAAAAAAA=
'{enrollment_id}' kaydını '{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama Hizmeti'nde yeni bir ayırma ilkesiyle güncelleştirin.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy geolatency --etag AAAAAAAAAAA= --iot-hubs {iot_hub_host_name1} {iot_hub_host_name2} {iot_hub_host_name3}
'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT Cihaz Sağlama Hizmeti'ndeki '{enrollment_id}' kaydını ilk ikiz özellikleri '{"location":{"region":"USA"}}', ilk ikiz etiketleri '{"version":"2"}' ve cihaz bilgileri '{"color":"red"}' ile güncelleştirin.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version1':'2'}" --device-info "{'color':'red'}"
Gerekli Parametreler
Tek tek cihaz kayıt kimliği.
İsteğe Bağlı Parametreler
Bir cihazın IoT Hub'a nasıl atandığını belirlemek için ayırma ilkesi türü. Sağlanmadıysa, ayırma ilkesi Cihaz Sağlama Hizmeti örneği için varsayılan olarak ayarlanan geçerli ayırma ilkesi olacaktır.
Özel ayırma isteğinde gönderilen sağlama hizmeti türlerinin API sürümü. Desteklenen en düşük sürüm: 2018-09-01-preview.
İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iotdps-data-auth-type=<auth-type-value>
yapılandırabilirsiniz.
Birincil sertifikayı içeren dosyanın yolu.
IoT Hub'a kayıtlı cihaz kimliği.
İsteğe bağlı cihaz bilgileri.
Azure IoT Hub Cihazı Sağlama Hizmeti'nin adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
Kenar etkinleştirmeyi gösteren bayrak.
BIR TPM cihazı için TPM onay anahtarı.
Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' değeri kullanılır.
Ayırma ilkesiyle ilişkili hedef IoT Hub'ının ana bilgisayar adı. Birden çok IoT Hub'ı için boşlukla ayrılmış liste kullanın.
İlk cihaz ikizi özellikleri.
İlk cihaz ikizi etiketleri.
Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --dps-name sağlanmadıysa gereklidir.
base64 biçiminde depolanan birincil simetrik paylaşılan erişim anahtarı.
Kayıt girdisini etkinleştirin veya devre dışı bırakın.
Geçerli birincil sertifikayı kaldırmak için bayrak ekleyin.
Geçerli ikincil sertifikayı kaldırmak için bayrak ekleyin.
Farklı bir IoT Hub'a yeniden sağlamada cihaz verilerinin nasıl işlenmesi gerektiğini belirleyen ilke.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İkincil sertifikayı içeren dosyanın yolu.
base64 biçiminde depolanan ikincil simetrik paylaşılan erişim anahtarı.
Özel ayırma istekleri için kullanılan Azure İşlevi web kancası URL'si.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.