Freigeben über


Microsoft.HybridCompute-Computer 2025-02-19-Preview

Bicep-Ressourcendefinition

Der Computerressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.HybridCompute/machines-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.HybridCompute/machines@2025-02-19-preview' = {
  identity: {
    type: 'SystemAssigned'
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    agentUpgrade: {
      correlationId: 'string'
      desiredVersion: 'string'
      enableAutomaticUpgrade: bool
    }
    clientPublicKey: 'string'
    cloudMetadata: {}
    extensions: [
      {
        name: 'string'
        status: {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
        type: 'string'
        typeHandlerVersion: 'string'
      }
    ]
    hardwareResourceId: 'string'
    identityKeyStore: 'string'
    licenseProfile: {
      esuProfile: {
        assignedLicense: {
          location: 'string'
          properties: {
            licenseDetails: {
              edition: 'string'
              processors: int
              state: 'string'
              target: 'string'
              type: 'string'
              volumeLicenseDetails: [
                {
                  invoiceId: 'string'
                  programYear: 'string'
                }
              ]
            }
            licenseType: 'string'
            tenantId: 'string'
          }
          tags: {
            {customized property}: 'string'
          }
        }
        licenseAssignmentState: 'string'
      }
    }
    locationData: {
      city: 'string'
      countryOrRegion: 'string'
      district: 'string'
      name: 'string'
    }
    mssqlDiscovered: 'string'
    osProfile: {
      linuxConfiguration: {
        patchSettings: {
          assessmentMode: 'string'
          enableHotpatching: bool
          patchMode: 'string'
        }
      }
      windowsConfiguration: {
        patchSettings: {
          assessmentMode: 'string'
          enableHotpatching: bool
          patchMode: 'string'
        }
      }
    }
    osType: 'string'
    parentClusterResourceId: 'string'
    privateLinkScopeResourceId: 'string'
    serviceStatuses: {
      extensionService: {
        startupType: 'string'
        status: 'string'
      }
      guestConfigurationService: {
        startupType: 'string'
        status: 'string'
      }
    }
    tpmEkCertificate: 'string'
    vmId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

Microsoft.HybridCompute/Maschinen

Name BESCHREIBUNG Wert
Identität Identität für die Ressource. Identität
Art Gibt an, welche Art von Arc-Computerplatzierung lokal platziert wird, z. B. HCI, SCVMM oder VMware usw. "AVS"
"AWS"
"EPS"
"GCP"
"HCI"
'SCVMM'
"VMware"
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge

Zwänge:
Min. Länge = 1
Maximale Länge = 54
Pattern = ^[a-zA-Z0-9-_\.]{1,54}$ (erforderlich)
Eigenschaften Hybrid compute machine properties MachineProperties-
Schlagwörter Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

Agenten-Upgrade

Name BESCHREIBUNG Wert
correlationId Die Korrelations-ID, die einem Agentupgradevorgang zugeordnet ist. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
gewünschte Version Gibt die Versionsinformationen w.r.t AgentUpgrade für den Computer an. Schnur
enableAutomaticUpgrade Gibt an, ob der Agent des Computers aktualisiert werden soll. Boolesch

Cloud-Metadaten

Name BESCHREIBUNG Wert

Identität

Name BESCHREIBUNG Wert
Typ Der Identitätstyp. 'SystemZugewiesen'

Lizenz

Name BESCHREIBUNG Wert
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Eigenschaften Hybrid Compute License-Eigenschaften LicenseProperties-
Schlagwörter Ressourcentags. TrackedResourceTags-

Details zur Lizenz

Name BESCHREIBUNG Wert
Edition Beschreibt die Edition der Lizenz. Die Werte sind entweder Standard oder Datacenter. "Rechenzentrum"
"Standard"
Prozessoren Beschreibt die Anzahl der Prozessoren. INT
Staat Beschreibt den Status der Lizenz. "Aktiviert"
"Deaktiviert"
Ziel Beschreibt den Lizenzzielserver. "Windows Server 2012 R2"
"Windows Server 2012"
Typ Beschreibt den Lizenzkerntyp (pCore oder vCore). 'Kern'
"virtueller Kern"
volumeLicenseDetails Eine Liste der Volumenlizenzdetails. VolumeLicenseDetails[]

LicenseProfileMachineInstanceView

Name BESCHREIBUNG Wert
esuProfil Eigenschaften für das Computer-ESU-Profil. LicenseProfileMachineInstanceViewEsuEigenschaften

LicenseProfileMachineInstanceViewEsuEigenschaften

Name BESCHREIBUNG Wert
zugewiesene Lizenz Die zugewiesene Lizenzressource. Lizenz
licenseAssignmentState Beschreibt den Lizenzzuweisungsstatus (zugewiesen oder nicht zugewiesen). 'Zugewiesen'
'Nicht zugewiesen'

Lizenz-Eigenschaften

Name BESCHREIBUNG Wert
licenseDetails Beschreibt die Eigenschaften einer Lizenz. LicenseDetails-
licenseType Der Typ der Lizenzressource. "ESU"
Mandanten-ID Beschreibt die Mandanten-ID. Schnur

Positionsdaten

Name BESCHREIBUNG Wert
Ort Die Stadt oder das Gebietsschema, in dem sich die Ressource befindet. Schnur
LandOderRegion Das Land oder die Region, in dem sich die Ressource befindet Schnur
Bezirk Der Bezirk, das Bundesland oder die Provinz, in dem sich die Ressource befindet. Schnur
Name Ein kanonischer Name für den geografischen oder physischen Standort. Zeichenfolge

Zwänge:
Maximale Länge = 256 (erforderlich)

MachineExtensionInstanceView

Name BESCHREIBUNG Wert
Name Der Name der Computererweiterung. Schnur
Status Instanzansichtsstatus. MachineExtensionInstanceViewStatus-
Typ Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". Schnur
typeHandlerVersion Gibt die Version des Skripthandlers an. Schnur

MachineExtensionInstanceViewStatus

Name BESCHREIBUNG Wert
Code Der Statuscode. Schnur
AnzeigeStatus Die kurze lokalisierbare Bezeichnung für den Status. Schnur
Niveau Der Ebenencode. 'Fehler'
'Infos'
"Warnung"
Nachricht Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen. Schnur
Zeit Die Uhrzeit des Status. Schnur

Maschineneigenschaften

Name BESCHREIBUNG Wert
AgentenUpgrade Die Informationen des Computers w.r.t Agent Upgrade AgentUpgrade-
clientPublicKey Öffentlicher Schlüssel, den der Client während des anfänglichen Ressourcen-Onboardings bereitstellt Schnur
cloudMetadaten Die Metadaten der Cloudumgebung (Azure/GCP/AWS/OCI...). CloudMetadata-
Erweiterungen Informationen zu Computererweiterungen (veraltetes Feld) MachineExtensionInstanceView[]
hardwareResourceId Gibt die Ressourcen-ID des zugeordneten Hardwaregeräts an. Nur von HCI RP festgelegt werden kann. Schnur
identityKeyStore Gibt den Identitätsschlüsselspeicher an, den ein Computer verwendet. 'Standard'
'TPM'
licenseProfil Gibt die lizenzbezogenen Eigenschaften für einen Computer an. LicenseProfileMachineInstanceView
Standort-Daten Metadaten, die sich auf den geografischen Standort der Ressource beziehen. LocationData-
mssqlEntdeckt Gibt an, ob eine MS SQL-Instanz auf dem Computer erkannt wird. Schnur
osProfil Gibt die Betriebssystemeinstellungen für den Hybridcomputer an. OSProfile-
osTyp Der Typ des Betriebssystems (Windows/Linux). Schnur
parentClusterResourceId Die Ressourcen-ID des übergeordneten Clusters (Azure HCI) wird diesem Computer zugewiesen, sofern vorhanden. Schnur
privateLinkScopeResourceId Die Ressourcen-ID des privaten Verknüpfungsbereichs, dem dieser Computer zugewiesen ist, falls vorhanden. Schnur
serviceStatuses Status der abhängigen Dienste, die an ARM gemeldet werden. ServiceStatuses-
tpmEkZertifikat Endorsement Key Certificate of the Trusted Platform Module (TPM), das der Client während des anfänglichen Ressourcen-Onboardings bereitstellt. Schnur
vmId (englisch) Gibt die eindeutige ID des Hybridcomputers an. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

OSProfile

Name BESCHREIBUNG Wert
linuxKonfiguration Gibt die Linux-Konfiguration für die Updateverwaltung an. OSProfileLinuxKonfiguration
windowsKonfiguration Gibt die Windows-Konfiguration für die Updateverwaltung an. OSProfileWindowsKonfiguration

OSProfileLinuxKonfiguration

Name BESCHREIBUNG Wert
patch-Einstellungen Gibt die Patcheinstellungen an. PatchSettings-

OSProfileWindowsKonfiguration

Name BESCHREIBUNG Wert
patch-Einstellungen Gibt die Patcheinstellungen an. PatchSettings-

Patch-Einstellungen

Name BESCHREIBUNG Wert
Bewertungsmodus Gibt den Bewertungsmodus an. 'AutomaticByPlatform'
'ImageDefault'
aktivierenHotpatching Erfasst die Registrierungsabsicht der Hotpatch-Funktionen der Kunden, mit der Kunden ihre Windows-Computer patchen können, ohne dass ein Neustart erforderlich ist. Boolesch
patch-Modus Gibt den Patchmodus an. "AutomaticByOS"
'AutomaticByPlatform'
'ImageDefault'
"Manuell"

Dienststatus

Name BESCHREIBUNG Wert
startupTyp Das Verhalten des Diensts, wenn der Arc-fähige Computer gestartet wird. Schnur
Status Zeigt den aktuellen Dienststatus an. Schnur

ServiceStatuses

Name BESCHREIBUNG Wert
ErweiterungService Der Status des Erweiterungsdiensts auf dem Arc-fähigen Computer. ServiceStatus-
guestConfigurationService Der Status des Gastkonfigurationsdiensts auf dem Arc-fähigen Computer. ServiceStatus-

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

VolumeLicenseDetails

Name BESCHREIBUNG Wert
Rechnung-ID Die Rechnungs-ID für die Volumenlizenz. Schnur
ProgrammJahr Beschreibt das Programmjahr, für das die Volumenlizenz gilt. "Jahr 1"
"Jahr 2"
"Jahr 3"

Verwendungsbeispiele

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Modul BESCHREIBUNG
Hybrid compute machine AVM-Ressourcenmodul für hybriden Computecomputer

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei BESCHREIBUNG
Erstellen einer Linux-VM aus einem Katalogimage in Azure Stack HCI- Diese Vorlage erstellt eine einfache Linux-VM aus dem referenzierten benutzerdefinierten Image in Azure Stack HCI, Version 23H2+
Erstellen eines virtuellen Computers aus dem referenzierten Image in Azure Stack HCI- Diese Vorlage erstellt eine einfache Windows-VM aus dem referenzierten Azure Marketplace-Image in Azure Stack HCI, Version 23H2+

ARM-Vorlagenressourcendefinition

Der Computerressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.HybridCompute/machines-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.HybridCompute/machines",
  "apiVersion": "2025-02-19-preview",
  "name": "string",
  "identity": {
    "type": "SystemAssigned"
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "agentUpgrade": {
      "correlationId": "string",
      "desiredVersion": "string",
      "enableAutomaticUpgrade": "bool"
    },
    "clientPublicKey": "string",
    "cloudMetadata": {
    },
    "extensions": [
      {
        "name": "string",
        "status": {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        },
        "type": "string",
        "typeHandlerVersion": "string"
      }
    ],
    "hardwareResourceId": "string",
    "identityKeyStore": "string",
    "licenseProfile": {
      "esuProfile": {
        "assignedLicense": {
          "location": "string",
          "properties": {
            "licenseDetails": {
              "edition": "string",
              "processors": "int",
              "state": "string",
              "target": "string",
              "type": "string",
              "volumeLicenseDetails": [
                {
                  "invoiceId": "string",
                  "programYear": "string"
                }
              ]
            },
            "licenseType": "string",
            "tenantId": "string"
          },
          "tags": {
            "{customized property}": "string"
          }
        },
        "licenseAssignmentState": "string"
      }
    },
    "locationData": {
      "city": "string",
      "countryOrRegion": "string",
      "district": "string",
      "name": "string"
    },
    "mssqlDiscovered": "string",
    "osProfile": {
      "linuxConfiguration": {
        "patchSettings": {
          "assessmentMode": "string",
          "enableHotpatching": "bool",
          "patchMode": "string"
        }
      },
      "windowsConfiguration": {
        "patchSettings": {
          "assessmentMode": "string",
          "enableHotpatching": "bool",
          "patchMode": "string"
        }
      }
    },
    "osType": "string",
    "parentClusterResourceId": "string",
    "privateLinkScopeResourceId": "string",
    "serviceStatuses": {
      "extensionService": {
        "startupType": "string",
        "status": "string"
      },
      "guestConfigurationService": {
        "startupType": "string",
        "status": "string"
      }
    },
    "tpmEkCertificate": "string",
    "vmId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

Microsoft.HybridCompute/Maschinen

Name BESCHREIBUNG Wert
apiVersion (Englisch) Die API-Version "2025-02-19-preview"
Identität Identität für die Ressource. Identität
Art Gibt an, welche Art von Arc-Computerplatzierung lokal platziert wird, z. B. HCI, SCVMM oder VMware usw. "AVS"
"AWS"
"EPS"
"GCP"
"HCI"
'SCVMM'
"VMware"
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge

Zwänge:
Min. Länge = 1
Maximale Länge = 54
Pattern = ^[a-zA-Z0-9-_\.]{1,54}$ (erforderlich)
Eigenschaften Hybrid compute machine properties MachineProperties-
Schlagwörter Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Typ Der Ressourcentyp "Microsoft.HybridCompute/machines"

Agenten-Upgrade

Name BESCHREIBUNG Wert
correlationId Die Korrelations-ID, die einem Agentupgradevorgang zugeordnet ist. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
gewünschte Version Gibt die Versionsinformationen w.r.t AgentUpgrade für den Computer an. Schnur
enableAutomaticUpgrade Gibt an, ob der Agent des Computers aktualisiert werden soll. Boolesch

Cloud-Metadaten

Name BESCHREIBUNG Wert

Identität

Name BESCHREIBUNG Wert
Typ Der Identitätstyp. 'SystemZugewiesen'

Lizenz

Name BESCHREIBUNG Wert
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Eigenschaften Hybrid Compute License-Eigenschaften LicenseProperties-
Schlagwörter Ressourcentags. TrackedResourceTags-

Details zur Lizenz

Name BESCHREIBUNG Wert
Edition Beschreibt die Edition der Lizenz. Die Werte sind entweder Standard oder Datacenter. "Rechenzentrum"
"Standard"
Prozessoren Beschreibt die Anzahl der Prozessoren. INT
Staat Beschreibt den Status der Lizenz. "Aktiviert"
"Deaktiviert"
Ziel Beschreibt den Lizenzzielserver. "Windows Server 2012 R2"
"Windows Server 2012"
Typ Beschreibt den Lizenzkerntyp (pCore oder vCore). 'Kern'
"virtueller Kern"
volumeLicenseDetails Eine Liste der Volumenlizenzdetails. VolumeLicenseDetails[]

LicenseProfileMachineInstanceView

Name BESCHREIBUNG Wert
esuProfil Eigenschaften für das Computer-ESU-Profil. LicenseProfileMachineInstanceViewEsuEigenschaften

LicenseProfileMachineInstanceViewEsuEigenschaften

Name BESCHREIBUNG Wert
zugewiesene Lizenz Die zugewiesene Lizenzressource. Lizenz
licenseAssignmentState Beschreibt den Lizenzzuweisungsstatus (zugewiesen oder nicht zugewiesen). 'Zugewiesen'
'Nicht zugewiesen'

Lizenz-Eigenschaften

Name BESCHREIBUNG Wert
licenseDetails Beschreibt die Eigenschaften einer Lizenz. LicenseDetails-
licenseType Der Typ der Lizenzressource. "ESU"
Mandanten-ID Beschreibt die Mandanten-ID. Schnur

Positionsdaten

Name BESCHREIBUNG Wert
Ort Die Stadt oder das Gebietsschema, in dem sich die Ressource befindet. Schnur
LandOderRegion Das Land oder die Region, in dem sich die Ressource befindet Schnur
Bezirk Der Bezirk, das Bundesland oder die Provinz, in dem sich die Ressource befindet. Schnur
Name Ein kanonischer Name für den geografischen oder physischen Standort. Zeichenfolge

Zwänge:
Maximale Länge = 256 (erforderlich)

MachineExtensionInstanceView

Name BESCHREIBUNG Wert
Name Der Name der Computererweiterung. Schnur
Status Instanzansichtsstatus. MachineExtensionInstanceViewStatus-
Typ Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". Schnur
typeHandlerVersion Gibt die Version des Skripthandlers an. Schnur

MachineExtensionInstanceViewStatus

Name BESCHREIBUNG Wert
Code Der Statuscode. Schnur
AnzeigeStatus Die kurze lokalisierbare Bezeichnung für den Status. Schnur
Niveau Der Ebenencode. 'Fehler'
'Infos'
"Warnung"
Nachricht Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen. Schnur
Zeit Die Uhrzeit des Status. Schnur

Maschineneigenschaften

Name BESCHREIBUNG Wert
AgentenUpgrade Die Informationen des Computers w.r.t Agent Upgrade AgentUpgrade-
clientPublicKey Öffentlicher Schlüssel, den der Client während des anfänglichen Ressourcen-Onboardings bereitstellt Schnur
cloudMetadaten Die Metadaten der Cloudumgebung (Azure/GCP/AWS/OCI...). CloudMetadata-
Erweiterungen Informationen zu Computererweiterungen (veraltetes Feld) MachineExtensionInstanceView[]
hardwareResourceId Gibt die Ressourcen-ID des zugeordneten Hardwaregeräts an. Nur von HCI RP festgelegt werden kann. Schnur
identityKeyStore Gibt den Identitätsschlüsselspeicher an, den ein Computer verwendet. 'Standard'
'TPM'
licenseProfil Gibt die lizenzbezogenen Eigenschaften für einen Computer an. LicenseProfileMachineInstanceView
Standort-Daten Metadaten, die sich auf den geografischen Standort der Ressource beziehen. LocationData-
mssqlEntdeckt Gibt an, ob eine MS SQL-Instanz auf dem Computer erkannt wird. Schnur
osProfil Gibt die Betriebssystemeinstellungen für den Hybridcomputer an. OSProfile-
osTyp Der Typ des Betriebssystems (Windows/Linux). Schnur
parentClusterResourceId Die Ressourcen-ID des übergeordneten Clusters (Azure HCI) wird diesem Computer zugewiesen, sofern vorhanden. Schnur
privateLinkScopeResourceId Die Ressourcen-ID des privaten Verknüpfungsbereichs, dem dieser Computer zugewiesen ist, falls vorhanden. Schnur
serviceStatuses Status der abhängigen Dienste, die an ARM gemeldet werden. ServiceStatuses-
tpmEkZertifikat Endorsement Key Certificate of the Trusted Platform Module (TPM), das der Client während des anfänglichen Ressourcen-Onboardings bereitstellt. Schnur
vmId (englisch) Gibt die eindeutige ID des Hybridcomputers an. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

OSProfile

Name BESCHREIBUNG Wert
linuxKonfiguration Gibt die Linux-Konfiguration für die Updateverwaltung an. OSProfileLinuxKonfiguration
windowsKonfiguration Gibt die Windows-Konfiguration für die Updateverwaltung an. OSProfileWindowsKonfiguration

OSProfileLinuxKonfiguration

Name BESCHREIBUNG Wert
patch-Einstellungen Gibt die Patcheinstellungen an. PatchSettings-

OSProfileWindowsKonfiguration

Name BESCHREIBUNG Wert
patch-Einstellungen Gibt die Patcheinstellungen an. PatchSettings-

Patch-Einstellungen

Name BESCHREIBUNG Wert
Bewertungsmodus Gibt den Bewertungsmodus an. 'AutomaticByPlatform'
'ImageDefault'
aktivierenHotpatching Erfasst die Registrierungsabsicht der Hotpatch-Funktionen der Kunden, mit der Kunden ihre Windows-Computer patchen können, ohne dass ein Neustart erforderlich ist. Boolesch
patch-Modus Gibt den Patchmodus an. "AutomaticByOS"
'AutomaticByPlatform'
'ImageDefault'
"Manuell"

Dienststatus

Name BESCHREIBUNG Wert
startupTyp Das Verhalten des Diensts, wenn der Arc-fähige Computer gestartet wird. Schnur
Status Zeigt den aktuellen Dienststatus an. Schnur

ServiceStatuses

Name BESCHREIBUNG Wert
ErweiterungService Der Status des Erweiterungsdiensts auf dem Arc-fähigen Computer. ServiceStatus-
guestConfigurationService Der Status des Gastkonfigurationsdiensts auf dem Arc-fähigen Computer. ServiceStatus-

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

VolumeLicenseDetails

Name BESCHREIBUNG Wert
Rechnung-ID Die Rechnungs-ID für die Volumenlizenz. Schnur
ProgrammJahr Beschreibt das Programmjahr, für das die Volumenlizenz gilt. "Jahr 1"
"Jahr 2"
"Jahr 3"

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Schablone BESCHREIBUNG
Erstellen einer Linux-VM aus einem Katalogimage in Azure Stack HCI-

Bereitstellung in Azure
Diese Vorlage erstellt eine einfache Linux-VM aus dem referenzierten benutzerdefinierten Image in Azure Stack HCI, Version 23H2+
Erstellen eines virtuellen Computers aus dem referenzierten Image in Azure Stack HCI-

Bereitstellung in Azure
Diese Vorlage erstellt eine einfache Windows-VM aus dem referenzierten Azure Marketplace-Image in Azure Stack HCI, Version 23H2+

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Computerressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.HybridCompute/machines-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.HybridCompute/machines@2025-02-19-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    properties = {
      agentUpgrade = {
        correlationId = "string"
        desiredVersion = "string"
        enableAutomaticUpgrade = bool
      }
      clientPublicKey = "string"
      cloudMetadata = {
      }
      extensions = [
        {
          name = "string"
          status = {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
          type = "string"
          typeHandlerVersion = "string"
        }
      ]
      hardwareResourceId = "string"
      identityKeyStore = "string"
      licenseProfile = {
        esuProfile = {
          assignedLicense = {
            location = "string"
            properties = {
              licenseDetails = {
                edition = "string"
                processors = int
                state = "string"
                target = "string"
                type = "string"
                volumeLicenseDetails = [
                  {
                    invoiceId = "string"
                    programYear = "string"
                  }
                ]
              }
              licenseType = "string"
              tenantId = "string"
            }
            tags = {
              {customized property} = "string"
            }
          }
          licenseAssignmentState = "string"
        }
      }
      locationData = {
        city = "string"
        countryOrRegion = "string"
        district = "string"
        name = "string"
      }
      mssqlDiscovered = "string"
      osProfile = {
        linuxConfiguration = {
          patchSettings = {
            assessmentMode = "string"
            enableHotpatching = bool
            patchMode = "string"
          }
        }
        windowsConfiguration = {
          patchSettings = {
            assessmentMode = "string"
            enableHotpatching = bool
            patchMode = "string"
          }
        }
      }
      osType = "string"
      parentClusterResourceId = "string"
      privateLinkScopeResourceId = "string"
      serviceStatuses = {
        extensionService = {
          startupType = "string"
          status = "string"
        }
        guestConfigurationService = {
          startupType = "string"
          status = "string"
        }
      }
      tpmEkCertificate = "string"
      vmId = "string"
    }
  }
}

Eigenschaftswerte

Microsoft.HybridCompute/Maschinen

Name BESCHREIBUNG Wert
Identität Identität für die Ressource. Identität
Art Gibt an, welche Art von Arc-Computerplatzierung lokal platziert wird, z. B. HCI, SCVMM oder VMware usw. "AVS"
"AWS"
"EPS"
"GCP"
"HCI"
'SCVMM'
"VMware"
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge

Zwänge:
Min. Länge = 1
Maximale Länge = 54
Pattern = ^[a-zA-Z0-9-_\.]{1,54}$ (erforderlich)
Eigenschaften Hybrid compute machine properties MachineProperties-
Schlagwörter Ressourcentags Wörterbuch der Tagnamen und -werte.
Typ Der Ressourcentyp "Microsoft.HybridCompute/machines@2025-02-19-preview"

Agenten-Upgrade

Name BESCHREIBUNG Wert
correlationId Die Korrelations-ID, die einem Agentupgradevorgang zugeordnet ist. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
gewünschte Version Gibt die Versionsinformationen w.r.t AgentUpgrade für den Computer an. Schnur
enableAutomaticUpgrade Gibt an, ob der Agent des Computers aktualisiert werden soll. Boolesch

Cloud-Metadaten

Name BESCHREIBUNG Wert

Identität

Name BESCHREIBUNG Wert
Typ Der Identitätstyp. 'SystemZugewiesen'

Lizenz

Name BESCHREIBUNG Wert
Standort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Eigenschaften Hybrid Compute License-Eigenschaften LicenseProperties-
Schlagwörter Ressourcentags. TrackedResourceTags-

Details zur Lizenz

Name BESCHREIBUNG Wert
Edition Beschreibt die Edition der Lizenz. Die Werte sind entweder Standard oder Datacenter. "Rechenzentrum"
"Standard"
Prozessoren Beschreibt die Anzahl der Prozessoren. INT
Staat Beschreibt den Status der Lizenz. "Aktiviert"
"Deaktiviert"
Ziel Beschreibt den Lizenzzielserver. "Windows Server 2012 R2"
"Windows Server 2012"
Typ Beschreibt den Lizenzkerntyp (pCore oder vCore). 'Kern'
"virtueller Kern"
volumeLicenseDetails Eine Liste der Volumenlizenzdetails. VolumeLicenseDetails[]

LicenseProfileMachineInstanceView

Name BESCHREIBUNG Wert
esuProfil Eigenschaften für das Computer-ESU-Profil. LicenseProfileMachineInstanceViewEsuEigenschaften

LicenseProfileMachineInstanceViewEsuEigenschaften

Name BESCHREIBUNG Wert
zugewiesene Lizenz Die zugewiesene Lizenzressource. Lizenz
licenseAssignmentState Beschreibt den Lizenzzuweisungsstatus (zugewiesen oder nicht zugewiesen). 'Zugewiesen'
'Nicht zugewiesen'

Lizenz-Eigenschaften

Name BESCHREIBUNG Wert
licenseDetails Beschreibt die Eigenschaften einer Lizenz. LicenseDetails-
licenseType Der Typ der Lizenzressource. "ESU"
Mandanten-ID Beschreibt die Mandanten-ID. Schnur

Positionsdaten

Name BESCHREIBUNG Wert
Ort Die Stadt oder das Gebietsschema, in dem sich die Ressource befindet. Schnur
LandOderRegion Das Land oder die Region, in dem sich die Ressource befindet Schnur
Bezirk Der Bezirk, das Bundesland oder die Provinz, in dem sich die Ressource befindet. Schnur
Name Ein kanonischer Name für den geografischen oder physischen Standort. Zeichenfolge

Zwänge:
Maximale Länge = 256 (erforderlich)

MachineExtensionInstanceView

Name BESCHREIBUNG Wert
Name Der Name der Computererweiterung. Schnur
Status Instanzansichtsstatus. MachineExtensionInstanceViewStatus-
Typ Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". Schnur
typeHandlerVersion Gibt die Version des Skripthandlers an. Schnur

MachineExtensionInstanceViewStatus

Name BESCHREIBUNG Wert
Code Der Statuscode. Schnur
AnzeigeStatus Die kurze lokalisierbare Bezeichnung für den Status. Schnur
Niveau Der Ebenencode. 'Fehler'
'Infos'
"Warnung"
Nachricht Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen. Schnur
Zeit Die Uhrzeit des Status. Schnur

Maschineneigenschaften

Name BESCHREIBUNG Wert
AgentenUpgrade Die Informationen des Computers w.r.t Agent Upgrade AgentUpgrade-
clientPublicKey Öffentlicher Schlüssel, den der Client während des anfänglichen Ressourcen-Onboardings bereitstellt Schnur
cloudMetadaten Die Metadaten der Cloudumgebung (Azure/GCP/AWS/OCI...). CloudMetadata-
Erweiterungen Informationen zu Computererweiterungen (veraltetes Feld) MachineExtensionInstanceView[]
hardwareResourceId Gibt die Ressourcen-ID des zugeordneten Hardwaregeräts an. Nur von HCI RP festgelegt werden kann. Schnur
identityKeyStore Gibt den Identitätsschlüsselspeicher an, den ein Computer verwendet. 'Standard'
'TPM'
licenseProfil Gibt die lizenzbezogenen Eigenschaften für einen Computer an. LicenseProfileMachineInstanceView
Standort-Daten Metadaten, die sich auf den geografischen Standort der Ressource beziehen. LocationData-
mssqlEntdeckt Gibt an, ob eine MS SQL-Instanz auf dem Computer erkannt wird. Schnur
osProfil Gibt die Betriebssystemeinstellungen für den Hybridcomputer an. OSProfile-
osTyp Der Typ des Betriebssystems (Windows/Linux). Schnur
parentClusterResourceId Die Ressourcen-ID des übergeordneten Clusters (Azure HCI) wird diesem Computer zugewiesen, sofern vorhanden. Schnur
privateLinkScopeResourceId Die Ressourcen-ID des privaten Verknüpfungsbereichs, dem dieser Computer zugewiesen ist, falls vorhanden. Schnur
serviceStatuses Status der abhängigen Dienste, die an ARM gemeldet werden. ServiceStatuses-
tpmEkZertifikat Endorsement Key Certificate of the Trusted Platform Module (TPM), das der Client während des anfänglichen Ressourcen-Onboardings bereitstellt. Schnur
vmId (englisch) Gibt die eindeutige ID des Hybridcomputers an. Zeichenfolge

Zwänge:
Min. Länge = 36
Maximale Länge = 36
Muster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

OSProfile

Name BESCHREIBUNG Wert
linuxKonfiguration Gibt die Linux-Konfiguration für die Updateverwaltung an. OSProfileLinuxKonfiguration
windowsKonfiguration Gibt die Windows-Konfiguration für die Updateverwaltung an. OSProfileWindowsKonfiguration

OSProfileLinuxKonfiguration

Name BESCHREIBUNG Wert
patch-Einstellungen Gibt die Patcheinstellungen an. PatchSettings-

OSProfileWindowsKonfiguration

Name BESCHREIBUNG Wert
patch-Einstellungen Gibt die Patcheinstellungen an. PatchSettings-

Patch-Einstellungen

Name BESCHREIBUNG Wert
Bewertungsmodus Gibt den Bewertungsmodus an. 'AutomaticByPlatform'
'ImageDefault'
aktivierenHotpatching Erfasst die Registrierungsabsicht der Hotpatch-Funktionen der Kunden, mit der Kunden ihre Windows-Computer patchen können, ohne dass ein Neustart erforderlich ist. Boolesch
patch-Modus Gibt den Patchmodus an. "AutomaticByOS"
'AutomaticByPlatform'
'ImageDefault'
"Manuell"

Dienststatus

Name BESCHREIBUNG Wert
startupTyp Das Verhalten des Diensts, wenn der Arc-fähige Computer gestartet wird. Schnur
Status Zeigt den aktuellen Dienststatus an. Schnur

ServiceStatuses

Name BESCHREIBUNG Wert
ErweiterungService Der Status des Erweiterungsdiensts auf dem Arc-fähigen Computer. ServiceStatus-
guestConfigurationService Der Status des Gastkonfigurationsdiensts auf dem Arc-fähigen Computer. ServiceStatus-

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

VolumeLicenseDetails

Name BESCHREIBUNG Wert
Rechnung-ID Die Rechnungs-ID für die Volumenlizenz. Schnur
ProgrammJahr Beschreibt das Programmjahr, für das die Volumenlizenz gilt. "Jahr 1"
"Jahr 2"
"Jahr 3"