Auf Englisch lesen

Freigeben über

Update-AzDeviceRegistryAsset

  • Referenz
Modul:
Az.DeviceRegistry

Aktualisieren einer Ressource

Syntax

PowerShell 
Update-AzDeviceRegistryAsset
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-Attribute <Hashtable>]
      [-Dataset <IDataset[]>]
      [-DefaultDatasetsConfiguration <String>]
      [-DefaultEventsConfiguration <String>]
      [-DefaultTopicPath <String>]
      [-DefaultTopicRetain <String>]
      [-Description <String>]
      [-DisplayName <String>]
      [-DocumentationUri <String>]
      [-Enabled]
      [-Event <IEvent[]>]
      [-HardwareRevision <String>]
      [-Manufacturer <String>]
      [-ManufacturerUri <String>]
      [-Model <String>]
      [-ProductCode <String>]
      [-SerialNumber <String>]
      [-SoftwareRevision <String>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-AzDeviceRegistryAsset
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-AzDeviceRegistryAsset
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell 
Update-AzDeviceRegistryAsset
      -InputObject <IDeviceRegistryIdentity>
      [-Attribute <Hashtable>]
      [-Dataset <IDataset[]>]
      [-DefaultDatasetsConfiguration <String>]
      [-DefaultEventsConfiguration <String>]
      [-DefaultTopicPath <String>]
      [-DefaultTopicRetain <String>]
      [-Description <String>]
      [-DisplayName <String>]
      [-DocumentationUri <String>]
      [-Enabled]
      [-Event <IEvent[]>]
      [-HardwareRevision <String>]
      [-Manufacturer <String>]
      [-ManufacturerUri <String>]
      [-Model <String>]
      [-ProductCode <String>]
      [-SerialNumber <String>]
      [-SoftwareRevision <String>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Aktualisieren einer Ressource

Beispiele

Beispiel 1: Aktualisieren einer Ressource nach Name und Ressourcengruppe.

PowerShell 
Update-AzDeviceRegistryAsset -Name test-asset -ResourceGroupName test-rg -Model ContosoModel2

Attribute                    : {
                               }
Dataset                      :
DefaultDatasetsConfiguration :
DefaultEventsConfiguration   :
DefaultTopicPath             :
DefaultTopicRetain           :
Description                  :
DiscoveredAssetRef           :
DisplayName                  :
DocumentationUri             :
Enabled                      :
Ref           :
Event                        :
ExtendedLocationName         :
ExtendedLocationType         :
ExternalAssetId              :
HardwareRevision             :
Id                                            : /subscriptions/xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx/providers/Microsoft.DeviceRegistry/locations/EASTUS2/operationStatuses/01e004d3-5ee4-4e48-b0f3-5d095967ff2f*22287DDA3F72A2BF66887E7D826E011DF68F456D735B7BE37C83763585936277
Location                     :
Manufacturer                 :
ManufacturerUri              :
Model                        :
Name                                          : 01e004d3-5ee4-4e48-b0f3-5d095967ff2f*22287DDA3F72A2BF66887E7D826E011DF68F456D735B7BE37C83763585936277
ProductCode                  :
ProvisioningState            :
ResourceGroupName            :
SerialNumber                 :
SoftwareRevision             :
StatusDataset                :
StatusError                  :
StatusEvent                  :
StatusVersion                :
SystemDataCreatedAt          :
SystemDataCreatedBy          :
SystemDataCreatedByType      :
SystemDataLastModifiedAt     :
SystemDataLastModifiedBy     :
SystemDataLastModifiedByType :
Tag                          : {
                               }
Type                         :
Uuid                         :
Version                      :

Mit diesem Befehl wird die Model Eigenschaft eines Objekts mit dem Wert ContosoModel2aktualisiert. Hinweis: Die Ausgabeantwort ist nur der Vorgangsstatus des Aktualisierungsbefehls, nicht die gepatchte Ressource.

Beispiel 2: UpdateViaIdentity für Ressourcen.

PowerShell 
$asset = @{ "ResourceGroupName" = "test-rg"; "AssetName" = "test-asset"; "SubscriptionId" = "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx"; }
Update-AzDeviceRegistryAsset -InputObject $asset -Model ContosoModel2

Attribute                    : {
                               }
Dataset                      :
DefaultDatasetsConfiguration :
DefaultEventsConfiguration   :
DefaultTopicPath             :
DefaultTopicRetain           :
Description                  :
DiscoveredAssetRef           :
DisplayName                  :
DocumentationUri             :
Enabled                      :
Ref           :
Event                        :
ExtendedLocationName         :
ExtendedLocationType         :
ExternalAssetId              :
HardwareRevision             :
Id                                            : /subscriptions/xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx/providers/Microsoft.DeviceRegistry/locations/EASTUS2/operationStatuses/01e004d3-5ee4-4e48-b0f3-5d095967ff2f*22287DDA3F72A2BF66887E7D826E011DF68F456D735B7BE37C83763585936277
Location                     :
Manufacturer                 :
ManufacturerUri              :
Model                        :
Name                                          : 01e004d3-5ee4-4e48-b0f3-5d095967ff2f*22287DDA3F72A2BF66887E7D826E011DF68F456D735B7BE37C83763585936277
ProductCode                  :
ProvisioningState            :
ResourceGroupName            :
SerialNumber                 :
SoftwareRevision             :
StatusDataset                :
StatusError                  :
StatusEvent                  :
StatusVersion                :
SystemDataCreatedAt          :
SystemDataCreatedBy          :
SystemDataCreatedByType      :
SystemDataLastModifiedAt     :
SystemDataLastModifiedBy     :
SystemDataLastModifiedByType :
Tag                          : {
                               }
Type                         :
Uuid                         :
Version                      :

Mit diesem Befehl wird die Model Eigenschaft eines Objekts mit wert ContosoModel2 über das Identity-Eingabeobjekt aktualisiert. Hinweis: Die Ausgabeantwort ist nur der Vorgangsstatus des Aktualisierungsbefehls, nicht die gepatchte Ressource.

Beispiel 3: Aktualisieren einer Ressource aus einem JSON-Dateipfad

PowerShell 
Update-AzDeviceRegistryAsset -Name test-asset -ResourceGroupName test-rg -JsonFilePath "C:\Users\abc\Desktop\assetPatch.json"

Attribute                    : {
                               }
Dataset                      :
DefaultDatasetsConfiguration :
DefaultEventsConfiguration   :
DefaultTopicPath             :
DefaultTopicRetain           :
Description                  :
DiscoveredAssetRef           :
DisplayName                  :
DocumentationUri             :
Enabled                      :
Ref           :
Event                        :
ExtendedLocationName         :
ExtendedLocationType         :
ExternalAssetId              :
HardwareRevision             :
Id                                            : /subscriptions/xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx/providers/Microsoft.DeviceRegistry/locations/EASTUS2/operationStatuses/01e004d3-5ee4-4e48-b0f3-5d095967ff2f*22287DDA3F72A2BF66887E7D826E011DF68F456D735B7BE37C83763585936277
Location                     :
Manufacturer                 :
ManufacturerUri              :
Model                        :
Name                                          : 01e004d3-5ee4-4e48-b0f3-5d095967ff2f*22287DDA3F72A2BF66887E7D826E011DF68F456D735B7BE37C83763585936277
ProductCode                  :
ProvisioningState            :
ResourceGroupName            :
SerialNumber                 :
SoftwareRevision             :
StatusDataset                :
StatusError                  :
StatusEvent                  :
StatusVersion                :
SystemDataCreatedAt          :
SystemDataCreatedBy          :
SystemDataCreatedByType      :
SystemDataLastModifiedAt     :
SystemDataLastModifiedBy     :
SystemDataLastModifiedByType :
Tag                          : {
                               }
Type                         :
Uuid                         :
Version                      :

Mit diesem Befehl wird die Eigenschaft(ies) einer Ressource mit neuen Werten aktualisiert, indem ein JSON-Dateipfad angegeben wird, der den Patchtext enthält. Hinweis: Die Ausgabeantwort ist nur der Vorgangsstatus des Aktualisierungsbefehls, nicht die gepatchte Ressource.

Beispiel 4: Aktualisieren einer Ressource aus einem Zeichenfolgen-JSON

PowerShell 
$jsonStr = '{
    "properties": {
        "model": "ContosoModel2"
    }
}'
Update-AzDeviceRegistryAsset -Name test-asset -ResourceGroupName test-rg -JsonString $jsonStr

Attribute                    : {
                               }
Dataset                      :
DefaultDatasetsConfiguration :
DefaultEventsConfiguration   :
DefaultTopicPath             :
DefaultTopicRetain           :
Description                  :
DiscoveredAssetRef           :
DisplayName                  :
DocumentationUri             :
Enabled                      :
Ref           :
Event                        :
ExtendedLocationName         :
ExtendedLocationType         :
ExternalAssetId              :
HardwareRevision             :
Id                                            : /subscriptions/xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx/providers/Microsoft.DeviceRegistry/locations/EASTUS2/operationStatuses/01e004d3-5ee4-4e48-b0f3-5d095967ff2f*22287DDA3F72A2BF66887E7D826E011DF68F456D735B7BE37C83763585936277
Location                     :
Manufacturer                 :
ManufacturerUri              :
Model                        :
Name                                          : 01e004d3-5ee4-4e48-b0f3-5d095967ff2f*22287DDA3F72A2BF66887E7D826E011DF68F456D735B7BE37C83763585936277
ProductCode                  :
ProvisioningState            :
ResourceGroupName            :
SerialNumber                 :
SoftwareRevision             :
StatusDataset                :
StatusError                  :
StatusEvent                  :
StatusVersion                :
SystemDataCreatedAt          :
SystemDataCreatedBy          :
SystemDataCreatedByType      :
SystemDataLastModifiedAt     :
SystemDataLastModifiedBy     :
SystemDataLastModifiedByType :
Tag                          : {
                               }
Type                         :
Uuid                         :
Version                      :

Mit diesem Befehl wird die Model Eigenschaft eines Objekts mit dem neuen Wert ContosoModel2 aktualisiert, indem der Patch als Zeichenfolgentext angegeben wird. Hinweis: Die Ausgabeantwort ist nur der Vorgangsstatus des Aktualisierungsbefehls, nicht die gepatchte Ressource.

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Attribute

Eine Reihe von Schlüsselwertpaaren, die vom Kunden festgelegte benutzerdefinierte Attribute enthalten.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Dataset

Array von Datasets, die Teil der Ressource sind. Jedes Dataset beschreibt die Datenpunkte, aus denen die Einrichtung besteht.

Typ:IDataset[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultDatasetsConfiguration

Stringified JSON that contains connector-specific default configuration for all datasets. Jedes Dataset kann über eine eigene Konfiguration verfügen, die die Standardeinstellungen hier außer Kraft setzt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultEventsConfiguration

Stringified JSON that contains connector-specific default configuration for all events. Jedes Ereignis kann über eine eigene Konfiguration verfügen, die hier die Standardeinstellungen außer Kraft setzt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultTopicPath

Der Themenpfad für Nachrichten, die in einem MQTT-Broker veröffentlicht wurden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultTopicRetain

Wenn sie auf "Beibehalten" festgelegt ist, werden nachrichten, die in einem MQTT-Broker veröffentlicht wurden, die Kennzeichnung beibehalten. Standard: 'Nie'.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Lesbare Beschreibung des Vermögenswerts.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Lesbarer Anzeigename.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DocumentationUri

Referenz zur Dokumentation.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Enabled

Status "Aktiviert/Deaktiviert" der Ressource.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Event

Array von Ereignissen, die Teil der Ressource sind. Jedes Ereignis kann über eine Ereigniskonfiguration verfügen.

Typ:IEvent[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HardwareRevision

Revisionsnummer der Hardware.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Identity-Parameter

Typ:IDeviceRegistryIdentity
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-JsonFilePath

Pfad der json-Datei, die für den Updatevorgang bereitgestellt wird

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JsonString

Json-Zeichenfolge, die für den Updatevorgang bereitgestellt wird

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Manufacturer

Name des Objektherstellers.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ManufacturerUri

Ressourcenhersteller-URI.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Model

Name des Objektmodells.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Parameter "Objektname".

Typ:String
Aliase:AssetName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProductCode

Produktcode für Ressourcen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SerialNumber

Seriennummer des Bestands.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftwareRevision

Revisionsnummer der Software.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubscriptionId

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

Typ:String
Position:Named
Standardwert:(Get-AzContext).Subscription.Id
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tag

Ressourcentags.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben