Set-AzIoTDeviceProvisioningServiceEnrollment
Atualizar um registro de registro de dispositivo.
Sintaxe
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>]
Description
Atualize um registro de dispositivo em um Serviço de Provisionamento de Dispositivo do Hub IoT do Azure.
Exemplos
Exemplo 1
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -AllocationPolicy Hashed -IotHub "hub1","hub2"
Atualize a política de alocação e os hubs para um registro de inscrição.
Exemplo 2
$tag = @{}
$tag.Add("environment","updatedenv")
$desired = @{}
$desired.add("version_dps", "updateddps")
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -tag $tag -Desired $desired
Atualize o estado gêmeo inicial de uma inscrição.
Exemplo 3
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -PrimaryCertificate ".\primaryCertificate.cer" -SecondaryCertificate ".\secondaryCertificate.cer"
Atualizar os certificados primários e secundários de um registro de chave simétrica
Parâmetros
-AllocationPolicy
Tipo de alocação para dispositivo atribuído ao Hub.
Tipo: | PSAllocationPolicy |
Valores aceites: | Hashed, GeoLatency, Static, Custom |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ApiVersion
A versão da API do serviço de provisionamento na solicitação de alocação personalizada.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Desired
Propriedades iniciais desejadas do gêmeo.
Tipo: | Hashtable |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DeviceId
ID do dispositivo do Hub IoT.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DpsName
Nome do Serviço de Provisionamento de Dispositivo IoT
Tipo: | String |
Position: | 1 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DpsObject
Objeto do Serviço de Provisionamento de Dispositivo IoT
Tipo: | PSProvisioningServiceDescription |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-EdgeEnabled
Sinalizador que indica a ativação da borda.
Tipo: | Boolean |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-EndorsementKey
Chave de endosso TPM para um dispositivo TPM.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-IotHub
Nome do host do Hub IoT de destino. Use uma lista separada por espaço para vários Hubs IoT.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-IotHubHostName
Nome do host do Hub IoT de destino.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-PrimaryCAName
O nome do certificado de autoridade de certificação raiz primária. Se o atestado com um certificado de autoridade de certificação raiz for desejado, um nome de autoridade de certificação raiz deverá ser fornecido.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-PrimaryCertificate
O caminho para o arquivo que contém o certificado primário. Representação Base-64 do certificado X509 .cer arquivo ou caminho do arquivo .pem.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-PrimaryKey
A chave de acesso compartilhada simétrica primária armazenada no formato base64.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ProvisioningStatus
Habilite ou desabilite a entrada de inscrição.
Tipo: | PSProvisioningStatus |
Valores aceites: | Enabled, Disabled |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-RegistrationId
ID de registo de inscrição individual.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ReprovisionPolicy
Dados do dispositivo a serem tratados no reprovisionamento para diferentes Iot Hub.
Tipo: | PSReprovisionType |
Valores aceites: | reprovisionandmigratedata, reprovisionandresetdata, never |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ResourceGroupName
Nome do grupo de recursos
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ResourceId
ID do recurso do serviço de provisionamento de dispositivo IoT
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-RootCertificate
Mude para atualizar o atestado X509 usando certificados raiz.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SecondaryCAName
O nome do certificado de autoridade de certificação raiz secundária. Se o atestado com um certificado de autoridade de certificação raiz for desejado, um nome de autoridade de certificação raiz deverá ser fornecido.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SecondaryCertificate
O caminho para o arquivo que contém o certificado secundário. Representação Base-64 do certificado X509 .cer arquivo ou caminho do arquivo .pem.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SecondaryKey
A chave de acesso compartilhada simétrica secundária armazenada no formato base64.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-StorageRootKey
Chave raiz de armazenamento TPM para um dispositivo TPM.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Tag
Tags gêmeas iniciais.
Tipo: | Hashtable |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WebhookUrl
A URL do webhook usada para solicitações de alocação personalizadas.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
Saídas
Azure PowerShell