Set-AzIoTDeviceProvisioningServiceEnrollment
Aktualizowanie rekordu rejestracji urządzenia.
Składnia
Set-AzIoTDeviceProvisioningServiceEnrollment
[-ResourceGroupName] <String>
[-DpsName] <String>
-RegistrationId <String>
[-DeviceId <String>]
[-ReprovisionPolicy <PSReprovisionType>]
[-EdgeEnabled <Boolean>]
[-Tag <Hashtable>]
[-Desired <Hashtable>]
[-AllocationPolicy <PSAllocationPolicy>]
[-ProvisioningStatus <PSProvisioningStatus>]
[-IotHubHostName <String>]
[-IotHub <String[]>]
[-WebhookUrl <String>]
[-ApiVersion <String>]
[-EndorsementKey <String>]
[-StorageRootKey <String>]
[-PrimaryKey <String>]
[-SecondaryKey <String>]
[-PrimaryCertificate <String>]
[-SecondaryCertificate <String>]
[-RootCertificate]
[-PrimaryCAName <String>]
[-SecondaryCAName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzIoTDeviceProvisioningServiceEnrollment
[-DpsObject] <PSProvisioningServiceDescription>
-RegistrationId <String>
[-DeviceId <String>]
[-ReprovisionPolicy <PSReprovisionType>]
[-EdgeEnabled <Boolean>]
[-Tag <Hashtable>]
[-Desired <Hashtable>]
[-AllocationPolicy <PSAllocationPolicy>]
[-ProvisioningStatus <PSProvisioningStatus>]
[-IotHubHostName <String>]
[-IotHub <String[]>]
[-WebhookUrl <String>]
[-ApiVersion <String>]
[-EndorsementKey <String>]
[-StorageRootKey <String>]
[-PrimaryKey <String>]
[-SecondaryKey <String>]
[-PrimaryCertificate <String>]
[-SecondaryCertificate <String>]
[-RootCertificate]
[-PrimaryCAName <String>]
[-SecondaryCAName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzIoTDeviceProvisioningServiceEnrollment
[-ResourceId] <String>
-RegistrationId <String>
[-DeviceId <String>]
[-ReprovisionPolicy <PSReprovisionType>]
[-EdgeEnabled <Boolean>]
[-Tag <Hashtable>]
[-Desired <Hashtable>]
[-AllocationPolicy <PSAllocationPolicy>]
[-ProvisioningStatus <PSProvisioningStatus>]
[-IotHubHostName <String>]
[-IotHub <String[]>]
[-WebhookUrl <String>]
[-ApiVersion <String>]
[-EndorsementKey <String>]
[-StorageRootKey <String>]
[-PrimaryKey <String>]
[-SecondaryKey <String>]
[-PrimaryCertificate <String>]
[-SecondaryCertificate <String>]
[-RootCertificate]
[-PrimaryCAName <String>]
[-SecondaryCAName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Aktualizowanie rejestracji urządzeń w usłudze Azure IoT Hub Device Provisioning Service.
Przykłady
Przykład 1
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -AllocationPolicy Hashed -IotHub "hub1","hub2"
Aktualizowanie zasad alokacji i centrów dla rekordu rejestracji.
Przykład 2
$tag = @{}
$tag.Add("environment","updatedenv")
$desired = @{}
$desired.add("version_dps", "updateddps")
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -tag $tag -Desired $desired
Zaktualizuj początkowy stan bliźniaczej reprezentacji rejestracji.
Przykład 3
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -PrimaryCertificate ".\primaryCertificate.cer" -SecondaryCertificate ".\secondaryCertificate.cer"
Aktualizowanie certyfikatów podstawowych i pomocniczych klucza symetrycznego
Parametry
-AllocationPolicy
Typ alokacji dla urządzenia przypisanego do centrum.
Typ: | PSAllocationPolicy |
Dopuszczalne wartości: | Hashed, GeoLatency, Static, Custom |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ApiVersion
Wersja interfejsu API usługi aprowizacji w niestandardowym żądaniu alokacji.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Desired
Początkowe żądane właściwości bliźniaczej reprezentacji bliźniaczej.
Typ: | Hashtable |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DeviceId
Identyfikator urządzenia usługi IoT Hub.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DpsName
Nazwa usługi IoT Device Provisioning
Typ: | String |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DpsObject
Obiekt usługi IoT Device Provisioning
Typ: | PSProvisioningServiceDescription |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-EdgeEnabled
Flaga wskazująca włączenie krawędzi.
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-EndorsementKey
Klucz poręczenia modułu TPM dla urządzenia TPM.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-IotHub
Nazwa hosta docelowego centrum IoT Hub. Użyj listy rozdzielanej spacjami dla wielu centrów IoT Hub.
Typ: | String[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-IotHubHostName
Nazwa hosta docelowego centrum IoT Hub.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PrimaryCAName
Nazwa podstawowego certyfikatu głównego urzędu certyfikacji. Jeśli wymagane jest zaświadczenie za pomocą certyfikatu głównego urzędu certyfikacji, należy podać nazwę głównego urzędu certyfikacji.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PrimaryCertificate
Ścieżka do pliku zawierającego certyfikat podstawowy. Reprezentacja certyfikatu X509 w formacie Base-64 .cer pliku lub ścieżki pliku pem.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PrimaryKey
Podstawowy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ProvisioningStatus
Włącz lub wyłącz wpis rejestracji.
Typ: | PSProvisioningStatus |
Dopuszczalne wartości: | Enabled, Disabled |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RegistrationId
Identyfikator rejestracji indywidualnej.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ReprovisionPolicy
Dane urządzenia, które mają być obsługiwane podczas ponownej aprowizacji w różnych centrach Iot Hub.
Typ: | PSReprovisionType |
Dopuszczalne wartości: | reprovisionandmigratedata, reprovisionandresetdata, never |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Nazwa grupy zasobów
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResourceId
Identyfikator zasobu usługi IoT Device Provisioning Service
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-RootCertificate
Przejdź do aktualizacji X509attestation przy użyciu certyfikatów głównych.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SecondaryCAName
Nazwa pomocniczego certyfikatu głównego urzędu certyfikacji. Jeśli wymagane jest zaświadczenie za pomocą certyfikatu głównego urzędu certyfikacji, należy podać nazwę głównego urzędu certyfikacji.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SecondaryCertificate
Ścieżka do pliku zawierającego certyfikat pomocniczy. Reprezentacja certyfikatu X509 w formacie Base-64 .cer pliku lub ścieżki pliku pem.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SecondaryKey
Pomocniczy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-StorageRootKey
Klucz główny magazynu modułu TPM dla urządzenia TPM.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Tag
Początkowe tagi bliźniaczych reprezentacji.
Typ: | Hashtable |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WebhookUrl
Adres URL elementu webhook używany do niestandardowych żądań alokacji.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |