az iot dps enrollment-group

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-group 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 kayıt gruplarını yönetme.

Komutlar

az iot dps enrollment-group compute-device-key

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki bir kayıt grubu için türetilmiş bir cihaz SAS anahtarı oluşturun.

az iot dps enrollment-group create

Azure IoT Hub Cihaz Sağlama Hizmeti'nde bir kayıt grubu oluşturun.

az iot dps enrollment-group delete

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki bir kayıt grubunu silin.

az iot dps enrollment-group list

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki kayıt gruplarını listeleme.

az iot dps enrollment-group registration

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki bir kayıt grubu için hizmet tarafı cihaz kayıtlarını yönetin.

az iot dps enrollment-group registration delete

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki bir kayıt grubu için cihaz kaydını silin.

az iot dps enrollment-group registration list

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki bir kayıt grubu için cihaz kayıtlarını listeleme.

az iot dps enrollment-group registration show

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki bir kayıt grubu için cihaz kaydı alın.

az iot dps enrollment-group show

Azure IoT Hub Cihaz Sağlama Hizmeti'nde kayıt grubunun ayrıntılarını alın.

az iot dps enrollment-group update

Azure IoT Hub Cihaz Sağlama Hizmeti'nde kayıt grubunu güncelleştirme.

az iot dps enrollment-group compute-device-key

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki bir kayıt grubu için türetilmiş bir cihaz SAS anahtarı oluşturun.

az iot dps enrollment-group compute-device-key --registration-id
                                               [--auth-type {key, login}]
                                               [--dps-name]
                                               [--eid]
                                               [--key]
                                               [--login]
                                               [--resource-group]

Örnekler

Verilen simetrik anahtarla cihaz anahtarını hesaplama.

az iot dps enrollment-group compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}

Verilen kayıt grubuyla cihaz anahtarını hesaplayın.

az iot dps enrollment-group compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}

Gerekli Parametreler

--registration-id --rid

Cihaz kaydının kimliği.

İsteğe Bağlı Parametreler

--auth-type

İş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.

kabul edilen değerler: key, login
varsayılan değer: key
--dps-name -n

Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa gereklidir.

--eid --enrollment-id --gid --group-id

Kayıt grubu kimliği.

--key --symmetric-key

Kayıt grubu için simetrik paylaşılan erişim anahtarı. Bu, Cihaz Sağlama Hizmeti kayıt defterini atlar ve sas belirtecini daha fazla doğrulama yapmadan doğrudan sağlanan simetrik anahtardan oluşturur. Kayıt kimliği dışındaki diğer tüm komut parametreleri yoksayılır.

--login -l

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.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az iot dps enrollment-group create

Azure IoT Hub Cihaz Sağlama Hizmeti'nde bir kayıt grubu oluşturun.

az iot dps enrollment-group create --eid
                                   [--allocation-policy {custom, geoLatency, hashed, static}]
                                   [--api-version]
                                   [--auth-type {key, login}]
                                   [--ca-name]
                                   [--certificate-path]
                                   [--dps-name]
                                   [--edge-enabled {false, true}]
                                   [--hn]
                                   [--ih]
                                   [--initial-twin-properties]
                                   [--initial-twin-tags]
                                   [--login]
                                   [--pk]
                                   [--provisioning-status {disabled, enabled}]
                                   [--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
                                   [--resource-group]
                                   [--scn]
                                   [--scp]
                                   [--secondary-key]
                                   [--webhook-url]

Örnekler

Birincil sertifika olarak bir ara sertifika kullanarak '{resource_group_name} kaynak grubundaki '{dps_name}' Azure IoT sağlama hizmetinde '{enrollment_id}' kayıt grubu oluşturun.

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem

İkincil sertifika olarak bir CA sertifikası {certificate_name} kullanarak '{resource_group_name} kaynak grubundaki '{dps_name}' Azure IoT sağlama hizmetinde '{enrollment_id}' kayıt grubu oluşturun.

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name}

'{resource_group_name}' kaynak grubundaki '{resource_group_name}' Azure IoT sağlama hizmetinde '{enrollment_id}' kayıt grubu oluşturun ve birincil sertifika olarak bir ara sertifika kullanarak sağlama durumu '{"location":{"region":"US"}}' ve ilk ikiz etiketleri '{"version_dps":"1"}'.

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem --provisioning-status enabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version_dps':'1'}"

Kanıtlama türü 'simetrik anahtar' olan '{resource_group_name} kaynak grubundaki '{dps_name}' Azure IoT sağlama hizmetinde '{enrollment_id}' kayıt grubu oluşturun.

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {primary_key} --secondary-key {secondary_key}

Özel ayırma ilkesiyle '{enrollment_id}' kayıt grubu oluşturun,

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}

Gerekli Parametreler

--eid --enrollment-id --gid --group-id

Kayıt grubu kimliği.

İsteğe Bağlı Parametreler

--allocation-policy --ap

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.

kabul edilen değerler: custom, geoLatency, hashed, static
--api-version --av

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

--auth-type

İş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.

kabul edilen değerler: key, login
varsayılan değer: key
--ca-name --cn --root-ca-name

Birincil kök CA sertifikasının adı. Kök CA sertifikası ile kanıtlama isteniyorsa bir kök ca adı sağlanmalıdır.

--certificate-path --cp

Birincil sertifikayı içeren dosyanın yolu. Ara sertifika ile kanıtlama isteniyorsa bir sertifika yolu sağlanmalıdır.

--dps-name -n

Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa gereklidir.

--edge-enabled --ee

Kenar etkinleştirmeyi gösteren bayrak.

kabul edilen değerler: false, true
--hn --iot-hub-host-name

Hedef IoT Hub ana bilgisayar adı. Bu parametre sağlanmışsa ayırma ilkesi varsayılan olarak statik olarak ayarlanır.

--ih --iot-hubs

Ayırma ilkesiyle ilişkili hedef IoT Hub ana bilgisayar adı. Birden çok IoT Hub'ı için boşlukla ayrılmış liste kullanın.

--initial-twin-properties --props

İlk cihaz ikizi özellikleri.

--initial-twin-tags --tags

İlk cihaz ikizi etiketleri.

--login -l

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.

--pk --primary-key

Base64 biçiminde depolanan birincil simetrik paylaşılan erişim anahtarı.

--provisioning-status --ps

Kayıt girişini etkinleştirin veya devre dışı bırakın.

kabul edilen değerler: disabled, enabled
--reprovision-policy --rp

Farklı bir IoT Hub yeniden sağlamada cihaz verilerinin nasıl işlenmesi gerektiğini belirleyen ilke.

kabul edilen değerler: never, reprovisionandmigratedata, reprovisionandresetdata
--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

--scn --secondary-ca-name --secondary-root-ca-name

İkincil kök CA sertifikasının adı. Kök CA sertifikası ile kanıtlama isteniyorsa bir kök ca adı sağlanmalıdır.

--scp --secondary-certificate-path

İkincil sertifikayı içeren dosyanın yolu. Ara sertifika ile kanıtlama isteniyorsa bir sertifika yolu sağlanmalıdır.

--secondary-key --sk

base64 biçiminde depolanan ikincil simetrik paylaşılan erişim anahtarı.

--webhook-url --wh

Özel ayırma istekleri için kullanılan Azure İşlevi web kancası URL'si.

az iot dps enrollment-group delete

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki bir kayıt grubunu silin.

az iot dps enrollment-group delete --eid
                                   [--auth-type {key, login}]
                                   [--dps-name]
                                   [--etag]
                                   [--login]
                                   [--resource-group]

Gerekli Parametreler

--eid --enrollment-id --gid --group-id

Kayıt grubu kimliği.

İsteğe Bağlı Parametreler

--auth-type

İş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.

kabul edilen değerler: key, login
varsayılan değer: key
--dps-name -n

Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa gereklidir.

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--login -l

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.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az iot dps enrollment-group list

Azure IoT Hub Cihaz Sağlama Hizmeti'ndeki kayıt gruplarını listeleme.

az iot dps enrollment-group list [--auth-type {key, login}]
                                 [--dps-name]
                                 [--login]
                                 [--resource-group]
                                 [--top]

İsteğe Bağlı Parametreler

--auth-type

İş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.

kabul edilen değerler: key, login
varsayılan değer: key
--dps-name -n

Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa gereklidir.

--login -l

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.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

--top

Döndürülecek öğe sayısı üst sınırı. Sınırsız için -1 kullanın.

az iot dps enrollment-group show

Azure IoT Hub Cihaz Sağlama Hizmeti'nde kayıt grubunun ayrıntılarını alın.

az iot dps enrollment-group show --eid
                                 [--auth-type {key, login}]
                                 [--dps-name]
                                 [--keys {false, true}]
                                 [--login]
                                 [--resource-group]

Örnekler

Temel kullanım

az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}

Simetrik anahtar kayıt grubu için sonuçlara tam kanıtlama bilgileri ekleme

az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys

Gerekli Parametreler

--eid --enrollment-id --gid --group-id

Kayıt grubu kimliği.

İsteğe Bağlı Parametreler

--auth-type

İş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.

kabul edilen değerler: key, login
varsayılan değer: key
--dps-name -n

Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa gereklidir.

--keys --show-keys

Kayıt grubu sonuçlarına kanıtlama anahtarlarını ve bilgilerini ekleyin.

kabul edilen değerler: false, true
--login -l

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.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az iot dps enrollment-group update

Azure IoT Hub Cihaz Sağlama Hizmeti'nde kayıt grubunu güncelleştirme.

az iot dps enrollment-group update --eid
                                   [--allocation-policy {custom, geoLatency, hashed, static}]
                                   [--api-version]
                                   [--auth-type {key, login}]
                                   [--ca-name]
                                   [--certificate-path]
                                   [--dps-name]
                                   [--edge-enabled {false, true}]
                                   [--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]
                                   [--scn]
                                   [--scp]
                                   [--secondary-key]
                                   [--webhook-url]

Örnekler

'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT sağlama hizmetindeki '{enrollment_id}' kayıt grubunu ilk ikiz özellikleri ve ilk ikiz etiketleriyle güncelleştirin.

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version_dps':'2'}" --etag AAAAAAAAAAA=

'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT sağlama hizmetindeki '{enrollment_id}' kayıt grubunu yeni birincil ara sertifikayla güncelleştirin ve mevcut ikincil ara sertifikayı kaldırın.

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --remove-secondary-certificate --etag AAAAAAAAAAA=

'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT sağlama hizmetindeki '{enrollment_id}' kayıt grubunu '{certificate_name}' yeni ikincil CA sertifikasıyla güncelleştirin ve var olan birincil CA sertifikasını kaldırın.

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name} --remove-certificate --etag AAAAAAAAAAA=

'{resource_group_name}' kaynak grubundaki '{dps_name}' Azure IoT sağlama hizmetindeki '{enrollment_id}' kayıt grubunu yeni birincil anahtarla güncelleştirin.

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=

Gerekli Parametreler

--eid --enrollment-id --gid --group-id

Kayıt grubu kimliği.

İsteğe Bağlı Parametreler

--allocation-policy --ap

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.

kabul edilen değerler: custom, geoLatency, hashed, static
--api-version --av

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

--auth-type

İş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.

kabul edilen değerler: key, login
varsayılan değer: key
--ca-name --cn --root-ca-name

Birincil kök CA sertifikasının adı. Kök CA sertifikası ile kanıtlama isteniyorsa bir kök ca adı sağlanmalıdır.

--certificate-path --cp

Birincil sertifikayı içeren dosyanın yolu. Ara sertifika ile kanıtlama isteniyorsa bir sertifika yolu sağlanmalıdır.

--dps-name -n

Azure IoT Hub Cihaz Sağlama Hizmeti'nin adı. --login sağlanmadıysa gereklidir.

--edge-enabled --ee

Kenar etkinleştirmeyi gösteren bayrak.

kabul edilen değerler: false, true
--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--hn --iot-hub-host-name

Hedef IoT Hub ana bilgisayar adı. Bu parametre sağlanmışsa ayırma ilkesi varsayılan olarak statik olarak ayarlanır.

--ih --iot-hubs

Ayırma ilkesiyle ilişkili hedef IoT Hub ana bilgisayar adı. Birden çok IoT Hub'ı için boşlukla ayrılmış liste kullanın.

--initial-twin-properties --props

İlk cihaz ikizi özellikleri.

--initial-twin-tags --tags

İlk cihaz ikizi etiketleri.

--login -l

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.

--pk --primary-key

Base64 biçiminde depolanan birincil simetrik paylaşılan erişim anahtarı.

--provisioning-status --ps

Kayıt girişini etkinleştirin veya devre dışı bırakın.

kabul edilen değerler: disabled, enabled
--rc --remove-certificate

Geçerli birincil sertifikayı kaldırmak için bayrak ekleyin.

kabul edilen değerler: false, true
--remove-secondary-certificate --rsc

Geçerli ikincil sertifikayı kaldırmak için bayrak ekleyin.

kabul edilen değerler: false, true
--reprovision-policy --rp

Farklı bir IoT Hub yeniden sağlamada cihaz verilerinin nasıl işlenmesi gerektiğini belirleyen ilke.

kabul edilen değerler: never, reprovisionandmigratedata, reprovisionandresetdata
--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

--scn --secondary-ca-name --secondary-root-ca-name

İkincil kök CA sertifikasının adı. Kök CA sertifikası ile kanıtlama isteniyorsa bir kök ca adı sağlanmalıdır.

--scp --secondary-certificate-path

İkincil sertifikayı içeren dosyanın yolu. Ara sertifika ile kanıtlama isteniyorsa bir sertifika yolu sağlanmalıdır.

--secondary-key --sk

base64 biçiminde depolanan ikincil simetrik paylaşılan erişim anahtarı.

--webhook-url --wh

Özel ayırma istekleri için kullanılan Azure İşlevi web kancası URL'si.