az dt

Notitie

Deze referentie maakt deel uit van de azure-iot-extensie voor Azure CLI en vereist versie 2.17.1 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u de eerste keer een az dt-opdracht hebt uitgevoerd. Meer informatie over extensies.

Beheer Azure Digital Twins oplossingen & infrastructuur.

Opdracht

az dt create

Maak of werk een Digital Twins bij.

az dt delete

Een bestaand Digital Twins verwijderen.

az dt endpoint

Beheer en configureer Digital Twins instantie-eindpunten.

az dt endpoint create

Voeg eindpunten voor een Digital Twins toe.

az dt endpoint create eventgrid

Voegt een EventGrid-onderwerp-eindpunt toe aan een Digital Twins exemplaar. Hiervoor is een vooraf gemaakte resource vereist.

az dt endpoint create eventhub

Voegt een EventHub-eindpunt toe aan een Digital Twins exemplaar. Hiervoor is een vooraf gemaakte resource vereist. Het exemplaar moet worden gemaakt met een beheerde identiteit ter ondersteuning van eindpuntintegratie op basis van identiteit.

az dt endpoint create servicebus

Voegt een ServiceBus-onderwerp-eindpunt toe aan een Digital Twins exemplaar. Hiervoor is een vooraf gemaakte resource vereist. Het exemplaar moet worden gemaakt met een beheerde identiteit ter ondersteuning van eindpuntintegratie op basis van identiteit.

az dt endpoint delete

Een eindpunt uit een Digital Twins verwijderen.

az dt endpoint list

Alle eindpunten voor egress die zijn geconfigureerd op een Digital Twins weergegeven.

az dt endpoint show

Details van een eindpunt dat is geconfigureerd op een Digital Twins tonen.

az dt endpoint wait

Wacht totdat een eindpuntbewerking is uitgevoerd.

az dt list

De verzameling Digital Twins instanties per abonnement of resourcegroep.

az dt model

DTDL-modellen en definities op een Digital Twins beheren.

az dt model create

Uploadt een of meer modellen. Wanneer er een fout optreedt, worden er geen modellen geüpload.

az dt model delete

Een model verwijderen. Een model kan alleen worden verwijderd als er geen andere modellen naar verwijzen.

az dt model delete-all

Verwijder alle modellen binnen een Digital Twins-instantie. Twins-configuraties worden niet beïnvloed, maar kunnen worden verbroken zonder modeldefinities.

az dt model list

Modelmetagegevens, definities en afhankelijkheden weergeven.

az dt model show

Haal een doelmodel of modeldefinitie op.

az dt model update

Werkt de metagegevens voor een model bij. Momenteel kan een model alleen worden gedecommisioneerd.

az dt network

Beheer Digital Twins netwerkconfiguratie met inbegrip van privékoppelingen en eindpuntverbindingen.

az dt network private-endpoint

Privé Digital Twins-eindpunten van een exemplaar beheren.

az dt network private-endpoint connection

Beheer Digital Twins privé-eindpuntverbindingen van het exemplaar.

az dt network private-endpoint connection delete

Verwijder een verbinding met een privé-eindpunt die is gekoppeld aan Digital Twins-exemplaar.

az dt network private-endpoint connection list

Privé-eindpuntverbindingen die zijn gekoppeld aan het Digital Twins-exemplaar.

az dt network private-endpoint connection set

Stel de status in van een privé-eindpuntverbinding die is gekoppeld aan het Digital Twins exemplaar.

az dt network private-endpoint connection show

Een verbinding met een privé-eindpunt die is gekoppeld aan het Digital Twins-exemplaar.

az dt network private-endpoint connection wait

Wacht totdat een bewerking voor een verbinding met een privé-eindpunt is voltooid.

az dt network private-link

Beheer Digital Twins privékoppelingsbewerkingen van het exemplaar.

az dt network private-link list

Privékoppelingen die aan het Digital Twins zijn gekoppeld.

az dt network private-link show

Een private-link tonen die is gekoppeld aan het exemplaar.

az dt reset

Stel een bestaand Digital Twins door gekoppelde assets te verwijderen. Momenteel worden alleen modellen en tweelingen verwijderd.

az dt role-assignment

RBAC-roltoewijzingen voor een Digital Twins beheren.

az dt role-assignment create

Wijs een gebruiker, groep of service-principal toe aan een rol voor een Digital Twins-instantie.

az dt role-assignment delete

Verwijder een roltoewijzing van een gebruiker, groep of service-principal uit een Digital Twins exemplaar.

az dt role-assignment list

De bestaande roltoewijzingen van een Digital Twins-instantie.

az dt route

Gebeurtenisroutes beheren en configureren.

az dt route create

Voeg een gebeurtenisroute toe aan een Digital Twins-exemplaar.

az dt route delete

Een gebeurtenisroute uit een Digital Twins verwijderen.

az dt route list

Hiermee worden de geconfigureerde gebeurtenisroutes van een Digital Twins weergegeven.

az dt route show

Details van een gebeurtenisroute die is geconfigureerd op een Digital Twins tonen.

az dt show

Een bestaande Digital Twins tonen.

az dt twin

De digitale tweelingen van een Digital Twins beheren en configureren.

az dt twin component

De digital twin-onderdelen van een Digital Twins en bijwerken.

az dt twin component show

Details van een digital twin-onderdeel tonen.

az dt twin component update

Werk een digital twin-onderdeel bij via de JSON-patchspecificatie.

az dt twin create

Maak een digitale tweeling op een exemplaar.

az dt twin delete

Een digitale tweeling verwijderen. Alle relaties die naar deze tweeling verwijzen, moeten al worden verwijderd.

az dt twin delete-all

Hiermee worden alle digitale tweelingen binnen een Digital Twins verwijderd, inclusief alle relaties voor deze tweelingen.

az dt twin query

Een query uitvoeren op de digitale tweelingen van een exemplaar. Hiermee kunt u relaties doorlopen en filteren op eigenschapswaarden.

az dt twin relationship

De digitale dubbelrelaties van een Digital Twins beheren en configureren.

az dt twin relationship create

Maak een relatie tussen de bron- en doel-digitale tweelingen.

az dt twin relationship delete

Verwijder een digital twin-relatie op een Digital Twins exemplaar.

az dt twin relationship delete-all

Hiermee verwijdert u alle digitale dubbelrelaties binnen een Digital Twins exemplaar, inclusief binnenkomende relaties.

az dt twin relationship list

De relaties van een digitale tweeling opnigeer.

az dt twin relationship show

Details van een digitale dubbelrelatie tonen.

az dt twin relationship update

Werkt de eigenschappen van een relatie tussen twee digitale tweelingen bij via JSON-patchspecificatie.

az dt twin show

De details van een digitale tweeling tonen.

az dt twin telemetry

Test en valideer de gebeurtenisroutes en eindpunten van een Digital Twins exemplaar.

az dt twin telemetry send

Verzendt telemetrie namens een digitale tweeling. Als het onderdeelpad is opgegeven, wordt de uitgezonden telemetrie namens het onderdeel gebruikt.

az dt twin update

Werk een digitale tweeling van het exemplaar bij via de JSON-patchspecificatie.

az dt wait

Wacht totdat een bewerking op een Digital Twins is voltooid.

az dt create

Maak of werk een Digital Twins bij.

az dt create --dt-name
             --resource-group
             [--assign-identity {false, true}]
             [--location]
             [--pna {Disabled, Enabled}]
             [--role]
             [--scopes]
             [--tags]

Voorbeelden

Maak een exemplaar in de doelresourcegroep met behulp van de locatie van de resourcegroep.

az dt create -n {instance_name} -g {resouce_group}

Maak een exemplaar in de doelresourcegroep met opgegeven locatie en tags.

az dt create -n {instance_name} -g {resouce_group} -l westus --tags a=b c=d

Maak een exemplaar in de doelresourcegroep met een door het systeem beheerde identiteit.

az dt create -n {instance_name} -g {resouce_group} --assign-identity

Maak een exemplaar in de doelresourcegroep met een door het systeem beheerde identiteit en wijs de identiteit vervolgens toe aan een of meer bereiken (gescheiden door spaties) met de rol Inzender.

az dt create -n {instance_name} -g {resouce_group} --assign-identity --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic"

Maak een exemplaar in de doelresourcegroep met een door het systeem beheerde identiteit en wijs de identiteit toe aan een of meer bereiken met een aangepaste opgegeven rol.

az dt create -n {instance_name} -g {resouce_group} --assign-identity --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic" --role MyCustomRole

Werk een exemplaar in de doelresourcegroep bij om een door het systeem beheerde identiteit in te stellen.

az dt create -n {instance_name} -g {resouce_group} --assign-identity

Werk een exemplaar in de doelresourcegroep bij om de door het systeem beheerde identiteit uit te schakelen.

az dt create -n {instance_name} -g {resouce_group} --assign-identity false

Werk een exemplaar in de doelresourcegroep bij met nieuwe tagwaarden en schakel openbare netwerktoegang uit.

az dt create -n {instance_name} -g {resouce_group} --tags env=prod --public-network-access Disabled

Vereiste parameters

--dt-name --dtn -n

Digital Twins instantienaam.

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

Optionele parameters

--assign-identity

Wijs een door het systeem gegenereerde identiteit toe aan het Digital Twins exemplaar.

geaccepteerde waarden: false, true
--location -l

Digital Twins instantielocatie. Als er geen locatie is opgegeven, wordt de locatie van de resourcegroep gebruikt. U kunt de standaardlocatie configureren met az configure --defaults location=<name> behulp van .

--pna --public-network-access

Bepaalt of het Digital Twins kan worden gebruikt vanuit een openbaar netwerk.

geaccepteerde waarden: Disabled, Enabled
standaardwaarde: Enabled
--role

Rolnaam of id van de door het systeem toegewezen identiteit.

standaardwaarde: Contributor
--scopes

Door ruimte gescheiden bereiken waar de door het systeem toegewezen identiteit toegang toe heeft.

--tags

Digital Twins-instantietags. Eigenschappentas in sleutel-waardeparen met de volgende indeling: a=b c=d.

az dt delete

Een bestaand Digital Twins verwijderen.

az dt delete --dt-name
             [--no-wait]
             [--resource-group]
             [--yes]

Voorbeelden

Verwijder een willekeurig exemplaar op blokkerende wijze met een bevestigingsprompt.

az dt delete -n {instance_name}

Verwijder een willekeurig exemplaar zonder blokkering of prompt.

az dt delete -n {instance_name} -y --no-wait

Vereiste parameters

--dt-name --dtn -n

Digital Twins instantienaam.

Optionele parameters

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--yes -y

Niet vragen om bevestiging.

az dt list

De verzameling Digital Twins instanties per abonnement of resourcegroep.

az dt list [--resource-group]

Voorbeelden

Vermeld alle exemplaren in het huidige abonnement.

az dt list

Alle exemplaren in de doelresourcegroep en uitvoer in tabelindeling.

az dt list -g {resource_group} --output table

Vermeld alle exemplaren in het abonnement die aan een voorwaarde voldoen.

az dt list --query "[?contains(name, 'Production')]"

Instanties tellen die voldoen aan de voorwaarde.

az dt list --query "length([?contains(name, 'Production')])"

Optionele parameters

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

az dt reset

Stel een bestaand Digital Twins door gekoppelde assets te verwijderen. Momenteel worden alleen modellen en tweelingen verwijderd.

az dt reset --dt-name
            [--resource-group]
            [--yes]

Voorbeelden

Stel alle assets voor een Digital Twins opnieuw in.

az dt reset -n {instance_name}

Vereiste parameters

--dt-name --dtn -n

Digital Twins instantienaam.

Optionele parameters

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--yes -y

Niet vragen om bevestiging.

az dt show

Een bestaande Digital Twins tonen.

az dt show --dt-name
           [--resource-group]

Voorbeelden

Een exemplaar tonen.

az dt show -n {instance_name}

Een exemplaar weergeven en bepaalde eigenschappen projecten.

az dt show -n {instance_name} --query "{Endpoint:hostName, Location:location}"

Vereiste parameters

--dt-name --dtn -n

Digital Twins instantienaam.

Optionele parameters

--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

az dt wait

Wacht totdat een bewerking op een Digital Twins is voltooid.

az dt wait --dt-name
           [--created]
           [--custom]
           [--deleted]
           [--exists]
           [--interval]
           [--resource-group]
           [--timeout]

Voorbeelden

Wacht totdat er een willekeurig exemplaar is gemaakt.

az dt wait -n {instance_name} --created

Wacht totdat een bestaand exemplaar is verwijderd.

az dt wait -n {instance_name} --deleted

Wacht totdat de eigenschap publicNetworkAccess van een bestaand exemplaar is ingesteld op Ingeschakeld

az dt wait -n {instance_name} --custom "publicNetworkAccess=='Enabled'"

Vereiste parameters

--dt-name --dtn -n

Digital Twins instantienaam.

Optionele parameters

--created

Wacht tot u met provisioningState bij Succeeded hebt gemaakt.

--custom

Wacht totdat de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht tot u deze hebt verwijderd.

--exists

Wacht totdat de resource bestaat.

--interval

Pollinginterval in seconden.

standaardwaarde: 30
--resource-group -g

Digital Twins resourcegroep van het exemplaar. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600