Set-AzIoTDeviceProvisioningServiceEnrollment

  • Pré-visualizar
Módulo:
Az.DeviceProvisioningServices Module

Este cmdlet faz parte de um módulo de visualização . As versões de visualização não são recomendadas para uso em ambientes de produção. Para obter mais informações, veja https://aka.ms/azps-refstatus.

Atualizar um registo de inscrição de dispositivo.

Sintaxe

ResourceSet (Predefinição) 

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>]

InputObjectSet 

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>]

ResourceIdSet 

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>]

Descrição

Atualize a inscrição de um dispositivo num Hub IoT do Azure Device Provisioning Service.

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.

Propriedades dos parâmetros

Tipo:PSAllocationPolicy
Valor predefinido:None
Valores aceites:Hashed, GeoLatency, Static, Custom
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ApiVersion

A versão da API do serviço de provisionamento na solicitação de alocação personalizada.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Desired

Propriedades iniciais desejadas do gêmeo.

Propriedades dos parâmetros

Tipo:Hashtable
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DeviceId

ID de dispositivo Hub IoT.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DpsName

Nome do Serviço de Provisionamento de Dispositivo IoT

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ResourceSet
Posto:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DpsObject

Objeto do Serviço de Provisionamento de Dispositivo IoT

Propriedades dos parâmetros

Tipo:PSProvisioningServiceDescription
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

InputObjectSet
Posto:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EdgeEnabled

Sinalizador que indica a ativação da borda.

Propriedades dos parâmetros

Tipo:Boolean
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EndorsementKey

Chave de endosso TPM para um dispositivo TPM.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IotHub

Nome de host do Hub IoT alvo. Use uma lista separada por espaço para vários Hubs IoT.

Propriedades dos parâmetros

Tipo:

String[]

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IotHubHostName

Nome do host do Hub IoT alvo.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PrimaryKey

A chave de acesso compartilhada simétrica primária armazenada no formato base64.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProvisioningStatus

Habilite ou desabilite a entrada de inscrição.

Propriedades dos parâmetros

Tipo:PSProvisioningStatus
Valor predefinido:None
Valores aceites:Enabled, Disabled
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RegistrationId

ID de registo de inscrição individual.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ReprovisionPolicy

Dados do dispositivo a serem tratados no reprovisionamento para diferentes Iot Hub.

Propriedades dos parâmetros

Tipo:PSReprovisionType
Valor predefinido:None
Valores aceites:reprovisionandmigratedata, reprovisionandresetdata, never
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

Nome do grupo de recursos

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ResourceSet
Posto:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceId

ID do recurso do serviço de provisionamento de dispositivo IoT

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ResourceIdSet
Posto:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-RootCertificate

Mude para atualizar o atestado X509 usando certificados raiz.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SecondaryKey

A chave de acesso compartilhada simétrica secundária armazenada no formato base64.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageRootKey

Chave raiz de armazenamento TPM para um dispositivo TPM.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Tag

Tags gêmeas iniciais.

Propriedades dos parâmetros

Tipo:Hashtable
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WebhookUrl

A URL do webhook usada para solicitações de alocação personalizadas.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSProvisioningServiceDescription

String

Saídas

PSIndividualEnrollment