az iot dps enrollment
Not
Bu başvuru, Azure CLI (sürüm 2.30.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
| az iot dps enrollment create |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek bir cihaz kaydı oluşturun. |
| az iot dps enrollment delete |
Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki tek bir cihaz kaydını silin. |
| az iot dps enrollment list |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek tek cihaz kayıtlarını listeleme. |
| 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. |
| az iot dps enrollment registration delete |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde bireysel kayıt için cihaz kaydını silin. |
| az iot dps enrollment registration show |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde bireysel kayıt için cihaz kaydı alma. |
| az iot dps enrollment show |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek tek cihaz kaydı ayrıntılarını alın. |
| az iot dps enrollment update |
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek bir cihaz kaydını güncelleştirin. |
az iot dps enrollment create
Azure IoT Hub Cihaz Sağlama Hizmeti'nde tek bir cihaz kaydı oluşturun.
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]
[--hn]
[--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 '{enrollment_id}' kaydı oluşturun ve sağlama durumu 'devre dışı' olarak ayarlayın, cihaz kimliği '{device_id}', 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ı.
Bireysel cihaz kayıt kimliği.
İsteğe Bağlı Parametreler
Bir cihazın bir IoT Hub 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 oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak 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 kaydedilen cihaz kimliği.
İsteğe bağlı cihaz bilgileri.
Azure IoT Hub Cihaz Sağlama Hizmeti'nin 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.
Hedef IoT Hub ana bilgisayar adı. Bu parametre sağlanmışsa ayırma ilkesi varsayılan olarak statik olarak ayarlanır.
Ayırma ilkesiyle ilişkili hedef IoT Hub 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ı dizesini 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ğlanmışsa, 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 girişini etkinleştirin veya devre dışı bırakın.
Farklı bir IoT Hub yeniden sağlamada cihaz verilerinin nasıl işlenmesi gerektiğini belirleyen ilke.
Kaynak grubunun adı. varsayılan grubu kullanarak 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.
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öster, uyarıları gizle.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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
Bireysel 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 oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iotdps-data-auth-type=<auth-type-value>yapılandırabilirsiniz.
Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa gereklidir.
Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.
Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --dps-name sağlanmadıysa gereklidir.
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
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öster, uyarıları gizle.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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 oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iotdps-data-auth-type=<auth-type-value>yapılandırabilirsiniz.
Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa gereklidir.
Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --dps-name sağlanmadıysa gereklidir.
Kaynak grubunun adı. varsayılan grubu kullanarak 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.
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öster, uyarıları gizle.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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 kaydı 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
Bireysel 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 oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iotdps-data-auth-type=<auth-type-value>yapılandırabilirsiniz.
Azure IoT Hub Cihaz Sağlama Hizmeti'nin 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ı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --dps-name sağlanmadıysa gereklidir.
Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.
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öster, uyarıları gizle.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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ştirin.
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]
[--hn]
[--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
Bireysel cihaz kayıt kimliği.
İsteğe Bağlı Parametreler
Bir cihazın bir IoT Hub 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 oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iotdps-data-auth-type=<auth-type-value>yapılandırabilirsiniz.
Birincil sertifikayı içeren dosyanın yolu.
IoT Hub kaydedilen cihaz kimliği.
İsteğe bağlı cihaz bilgileri.
Azure IoT Hub Cihaz Sağlama Hizmeti'nin 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ğlanmazsa '*' değeri kullanılır.
Hedef IoT Hub ana bilgisayar adı. Bu parametre sağlanmışsa ayırma ilkesi varsayılan olarak statik olarak ayarlanır.
Ayırma ilkesiyle ilişkili hedef IoT Hub 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ı dizesini 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ğlanmışsa, 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 girişini 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 yeniden sağlamada cihaz verilerinin nasıl işlenmesi gerektiğini belirleyen ilke.
Kaynak grubunun adı. varsayılan grubu kullanarak 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.
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öster, uyarıları gizle.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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.