Set-AzIoTDeviceProvisioningServiceEnrollment

Förhandsgranskning

Modul:: Az.DeviceProvisioningServices Module

Den här cmdleten är en del av en förhandsversionsmodul . Förhandsversioner rekommenderas inte för användning i produktionsmiljöer. Mer information finns i .

Uppdatera en enhetsregistreringspost.

Syntax

ResourceSet (Standard)

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

Description

Uppdatera en enhetsregistrering i en Azure IoT Hub Device Provisioning Service.

Exempel

Exempel 1

Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -AllocationPolicy Hashed -IotHub "hub1","hub2"

Uppdatera allokeringsprincip och hubbar för en registreringspost.

Exempel 2

$tag = @{}
$tag.Add("environment","updatedenv")
$desired = @{}
$desired.add("version_dps", "updateddps")
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -tag $tag -Desired $desired

Uppdatera en registrerings ursprungliga tvillingtillstånd.

Exempel 3

Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -PrimaryCertificate ".\primaryCertificate.cer" -SecondaryCertificate ".\secondaryCertificate.cer"

Uppdatera en symmetrisk nyckelregistrerings primära och sekundära certifikat

Parametrar

-AllocationPolicy

Typ av allokering för enhet som tilldelats till hubben.

Parameteregenskaper

Typ:	PSAllocationPolicy
Standardvärde:	None
Godkända värden:	Hashed, GeoLatency, Static, Custom
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ApiVersion

API-versionen av etableringstjänsten i den anpassade allokeringsbegäran.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	jfr

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:	IAzureContextContainer
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Desired

Önskade egenskaper för inledande tvilling.

Parameteregenskaper

Typ:	Hashtable
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DeviceId

IoT Hub enhets-ID.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DpsName

Namnet på IoT Device Provisioning Service

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

ResourceSet

Position:	1
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DpsObject

IoT Device Provisioning Service-objekt

Parameteregenskaper

Typ:	PSProvisioningServiceDescription
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

InputObjectSet

Position:	0
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-EdgeEnabled

Flagga som anger kantaktivering.

Parameteregenskaper

Typ:	Boolean
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-EndorsementKey

TPM-bekräftelsenyckel för en TPM-enhet.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-IotHub

Värdnamn för mål IoT Hub. Använd blankstegsavgränsad lista för flera IoT Hubs.

Parameteregenskaper

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-IotHubHostName

Värdnamnet för målet IoT Hub.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-PrimaryCAName

Namnet på det primära rotcertifikatutfärdarcertifikatet. Om attestering med ett rotcertifikatutfärdarcertifikat önskas måste ett rotcertifikatutfärdarnamn anges.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-PrimaryCertificate

Sökvägen till filen som innehåller det primära certifikatet. Base-64-representation av X509-certifikat .cer fil- eller .pem-filsökväg.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-PrimaryKey

Den primära symmetriska delade åtkomstnyckeln som lagras i base64-format.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ProvisioningStatus

Aktivera eller inaktivera registreringspost.

Parameteregenskaper

Typ:	PSProvisioningStatus
Standardvärde:	None
Godkända värden:	Enabled, Disabled
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-RegistrationId

Registrerings-ID för enskilda registreringar.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ReprovisionPolicy

Enhetsdata som ska hanteras vid återetablering till en annan Iot Hub.

Parameteregenskaper

Typ:	PSReprovisionType
Standardvärde:	None
Godkända värden:	reprovisionandmigratedata, reprovisionandresetdata, never
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceGroupName

Namnet på resursgruppen

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

ResourceSet

Position:	0
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceId

Resurs-ID för IoT Device Provisioning Service

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

ResourceIdSet

Position:	0
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-RootCertificate

Växla till att uppdatera X509attestation med rotcertifikat.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-SecondaryCAName

Namnet på det sekundära rotcertifikatutfärdarcertifikatet. Om attestering med ett rotcertifikatutfärdarcertifikat önskas måste ett rotcertifikatutfärdarnamn anges.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-SecondaryCertificate

Sökvägen till filen som innehåller det sekundära certifikatet. Base-64-representation av X509-certifikat .cer fil- eller .pem-filsökväg.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-SecondaryKey

Den sekundära symmetriska delade åtkomstnyckeln som lagras i base64-format.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-StorageRootKey

TPM-lagringsrotnyckel för en TPM-enhet.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Tag

Inledande tvillingtaggar.

Parameteregenskaper

Typ:	Hashtable
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-WebhookUrl

Webhook-URL:en som används för anpassade allokeringsbegäranden.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	Wi

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.