Set-AzIoTDeviceProvisioningServiceEnrollmentGroup

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 enhetsregistreringsgrupp.

Syntax

ResourceSet (Standard)

Set-AzIoTDeviceProvisioningServiceEnrollmentGroup
    [-ResourceGroupName] <String>
    [-DpsName] <String>
    -Name <String>
    [-ReprovisionPolicy <PSReprovisionType>]
    [-EdgeEnabled <Boolean>]
    [-Tag <Hashtable>]
    [-Desired <Hashtable>]
    [-AllocationPolicy <PSAllocationPolicy>]
    [-ProvisioningStatus <PSProvisioningStatus>]
    [-IotHubHostName <String>]
    [-IotHub <String[]>]
    [-WebhookUrl <String>]
    [-ApiVersion <String>]
    [-PrimaryKey <String>]
    [-SecondaryKey <String>]
    [-PrimaryCertificate <String>]
    [-SecondaryCertificate <String>]
    [-RootCertificate]
    [-PrimaryCAName <String>]
    [-SecondaryCAName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectSet

Set-AzIoTDeviceProvisioningServiceEnrollmentGroup
    [-DpsObject] <PSProvisioningServiceDescription>
    -Name <String>
    [-ReprovisionPolicy <PSReprovisionType>]
    [-EdgeEnabled <Boolean>]
    [-Tag <Hashtable>]
    [-Desired <Hashtable>]
    [-AllocationPolicy <PSAllocationPolicy>]
    [-ProvisioningStatus <PSProvisioningStatus>]
    [-IotHubHostName <String>]
    [-IotHub <String[]>]
    [-WebhookUrl <String>]
    [-ApiVersion <String>]
    [-PrimaryKey <String>]
    [-SecondaryKey <String>]
    [-PrimaryCertificate <String>]
    [-SecondaryCertificate <String>]
    [-RootCertificate]
    [-PrimaryCAName <String>]
    [-SecondaryCAName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdSet

Set-AzIoTDeviceProvisioningServiceEnrollmentGroup
    [-ResourceId] <String>
    -Name <String>
    [-ReprovisionPolicy <PSReprovisionType>]
    [-EdgeEnabled <Boolean>]
    [-Tag <Hashtable>]
    [-Desired <Hashtable>]
    [-AllocationPolicy <PSAllocationPolicy>]
    [-ProvisioningStatus <PSProvisioningStatus>]
    [-IotHubHostName <String>]
    [-IotHub <String[]>]
    [-WebhookUrl <String>]
    [-ApiVersion <String>]
    [-PrimaryKey <String>]
    [-SecondaryKey <String>]
    [-PrimaryCertificate <String>]
    [-SecondaryCertificate <String>]
    [-RootCertificate]
    [-PrimaryCAName <String>]
    [-SecondaryCAName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

Exempel

Exempel 1

Set-AzIoTDeviceProvisioningServiceEnrollmentGroup -ResourceGroupName "myresourcegroup" -DpsName "mydps" -Name "enroll1" -AllocationPolicy Hashed -IotHub "hub1","hub2"

Uppdatera allokeringsprincip och hubbar för en registreringsgrupp.

Exempel 2

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

Uppdatera en registreringsgrupps inledande tvillingtillstånd.

Exempel 3

Set-AzIoTDeviceProvisioningServiceEnrollmentGroup -ResourceGroupName "myresourcegroup" -DpsName "mydps" -Name "enroll1" -PrimaryKey "newPrimaryKey" -SecondaryKey "newSecondaryKey"

Uppdatera en symmetrisk nyckelregistreringsgrupps primära och sekundära nycklar

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

-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

-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

-Name

Namnet på registreringsgruppen.

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

-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

-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

Tillåter att du skapar 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

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

Indata

PSProvisioningServiceDescription

String

Utdata

PSEnrollmentGroup