Add-AzIotHubConfiguration
Tambahkan konfigurasi manajemen perangkat otomatis IoT di IoT Hub target.
Sintaks
ResourceSet (Default)
Add-AzIotHubConfiguration
[-ResourceGroupName] <String>
[-IotHubName] <String>
-Name <String>
[-DeviceContent <Hashtable>]
[-Priority <Int32>]
[-TargetCondition <String>]
[-Metric <Hashtable>]
[-Label <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-AzIotHubConfiguration
[-InputObject] <PSIotHub>
-Name <String>
[-DeviceContent <Hashtable>]
[-Priority <Int32>]
[-TargetCondition <String>]
[-Metric <Hashtable>]
[-Label <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceIdSet
Add-AzIotHubConfiguration
[-ResourceId] <String>
-Name <String>
[-DeviceContent <Hashtable>]
[-Priority <Int32>]
[-TargetCondition <String>]
[-Metric <Hashtable>]
[-Label <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Konten konfigurasi adalah json dan sedikit bervariasi berdasarkan niat perangkat atau modul.
Konfigurasi perangkat dalam bentuk {"deviceContent":{...}}
Konfigurasi modul dalam bentuk {"moduleContent":{...}}
Konfigurasi dapat ditentukan dengan metrik yang disediakan pengguna untuk evaluasi sesuai permintaan.
Metrik pengguna adalah json dan dalam bentuk {"kueri":{...}} atau {"metrics":{"queries":{...}}}.
Catatan: Kondisi target untuk modul harus dimulai dengan "from devices.modules where". Lihat https://learn.microsoft.com/azure/iot-hub/iot-hub-automatic-device-management untuk informasi lebih lanjut.
Contoh
Contoh 1
Add-AzIotHubConfiguration -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "config1"
Buat konfigurasi perangkat dengan metadata default.
Contoh 2
Add-AzIotHubConfiguration -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "config1" -Priority 3 -TargetCondition "tags.building=9 and tags.environment='test'"
Buat konfigurasi perangkat dengan prioritas 3 yang berlaku pada kondisi saat perangkat ditandai dalam bangunan 9 dan lingkungannya adalah 'uji'.
Contoh 3
$metrics = @{}
$metrics.add("query1", "select deviceId from devices where tags.location='US'")
Add-AzIotHubConfiguration -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "config1" -Metric $metrics
Buat konfigurasi perangkat dengan metrik pengguna.
Contoh 4
$labels = @{}
$labels.add("key0","value0")
$labels.add("key1","value1")
Add-AzIotHubConfiguration -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "config1" -Label $labels
Buat konfigurasi perangkat dengan label.
Contoh 5
$prop = @{}
$prop.add("Location", "US")
$content = @{}
$content.add("properties.desired.Region", $prop)
Add-AzIotHubConfiguration -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "config1" -DeviceContent $content
Buat konfigurasi perangkat dengan konten.
Parameter
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Alias: Cf
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.
Properti parameter
Jenis: IAzureContextContainer
Nilai default: None
Mendukung wildcard: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-DeviceContent
Konfigurasi untuk perangkat IotHub.
Properti parameter
Jenis: Hashtable
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
Objek IotHub
Jenis: PSIotHub
Nilai default: None
Mendukung wildcard: False
DontShow: False
InputObjectSet
Position: 0
Wajib: True
Nilai dari alur: True
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-IotHubName
Nama Iot Hub
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
ResourceSet
Position: 1
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Label
Peta label yang akan diterapkan ke konfigurasi target.
Properti parameter
Jenis: Hashtable
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Metric
Kumpulan kueri untuk definisi metrik konfigurasi.
Properti parameter
Jenis: Hashtable
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Name
Pengidentifikasi untuk konfigurasi.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-Priority
Bobot konfigurasi perangkat jika ada aturan yang bersaing (kemenangan tertinggi).
Properti parameter
Jenis: Int32
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-ResourceGroupName
Nama Grup Sumber Daya
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
ResourceSet
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-ResourceId
Id Sumber Daya IotHub
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
ResourceIdSet
Position: 0
Wajib: True
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: True
Nilai dari argumen yang tersisa: False
-TargetCondition
Kondisi target tempat konfigurasi perangkat berlaku.
Properti parameter
Jenis: String
Nilai default: None
Mendukung wildcard: False
DontShow: False
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan.
Cmdlet tidak dijalankan.
Properti parameter
Jenis: SwitchParameter
Nilai default: None
Mendukung wildcard: False
DontShow: False
Alias: wi
Kumpulan parameter
(All)
Position: Named
Wajib: False
Nilai dari alur: False
Nilai dari alur berdasarkan nama properti: False
Nilai dari argumen yang tersisa: False
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters .
Output