Licenties voor uitgebreide beveiligingsupdates van Azure Arc programmatisch implementeren en beheren

Dit artikel bevat instructies voor het programmatisch inrichten en beheren van Windows Server uitgebreide beveiligingsupdates levenscyclusbewerkingen via de Azure Arc ESU ARM API's. De instructies zijn van toepassing op Windows Server 2012/2012 R2 en Windows Server 2016. Gebruik de selector boven aan het artikel om de versie van het besturingssysteem te kiezen die u licentie geeft.

Voer voor elk van de API-opdrachten die in dit artikel worden uitgelegd, nauwkeurige parameterinformatie in voor locatie, status, editie, type en processors, afhankelijk van uw specifieke scenario. Stel de target eigenschap in op het besturingssysteem waarvoor u licenties hebt:

  • Windows Server 2012
  • Windows Server 2012 R2
  • Windows Server 2016

Notitie

U moet een service-principal maken om de Azure-API te gebruiken voor het beheren van ESU's. Zie Connect hybrid machines to Azure at scale and Azure REST API reference (Hybride machines verbinden met Azure op schaal) voor meer informatie.

Een licentie inrichten

Voer de volgende opdracht uit om een licentie in te richten:

PUT  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview 
{  
    "location": "ENTER-REGION",  
    "properties": {  
        "licenseDetails": {  
            "state": "Activated",  
            "target": "Windows Server 2012",  
            "Edition": "Datacenter",  
            "Type": "pCore",  
            "Processors": 12  
        }  
    }  
}

PUT  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview 
{  
    "location": "ENTER-REGION",  
    "properties": {  
        "licenseDetails": {  
            "state": "Activated",  
            "target": "Windows Server 2016",  
            "Edition": "Datacenter",  
            "Type": "pCore",  
            "Processors": 12  
        }  
    }  
}

Programmatisch kunt u Azure CLI gebruiken om nieuwe licenties te genereren, waarbij u de Volume License Details parameter opgeeft in uw volumelicentierechten van jaar 1 door de respectieve factuurnummers in te voeren. U moet expliciet de factuur-id (nummer) opgeven in uw licentieinrichting voor Azure Arc:

az connectedmachine license create --license-name
                                   --resource-group
                                   [--edition {Datacenter, Standard}]
                                   [--license-type {ESU}]
                                   [--location]
                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--processors]
                                   [--state {Activated, Deactivated}]
                                   [--tags]
                                   [--target {Windows Server 2012, Windows Server 2012 R2}]
                                   [--tenant-id]
                                   [--type {pCore, vCore}]
                                   [--volume-license-details]

Overstappen van volumelicenties

Overstappen van volumelicenties wordt niet ondersteund voor Windows Server 2016 ESU's die zijn ingeschakeld door Azure Arc.

Voer de volgende opdracht uit om een licentie te koppelen:

PUT  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/machines/MACHINE_NAME/licenseProfiles/default?api-version=2023-06-20-preview 
{
   "location": "SAME_REGION_AS_MACHINE",
   "properties": {
      "esuProfile": {
         "assignedLicense": "RESOURCE_ID_OF_LICENSE"
      }
   }
}

Als u een licentie wilt ontkoppelen, voert u de volgende opdracht uit:

PUT 
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/machines/MACHINE_NAME/licenseProfiles/default?api-version=2023-06-20-preview
{
  "location": "SAME_REGION_AS_MACHINE",
  "properties": {
    "esuProfile": {
    }
  }
}

Een licentie wijzigen

Voer de volgende opdracht uit om een licentie te wijzigen:

PUT/PATCH 
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview 
{  
    "location": "ENTER-REGION",  
    "properties": {  
        "licenseDetails": {  
            "state": "Activated",  
            "target": "Windows Server 2012",  
            "Edition": "Datacenter",  
            "Type": "pCore",  
            "Processors": 12  
        }  
    }  
}

PUT/PATCH 
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview 
{  
    "location": "ENTER-REGION",  
    "properties": {  
        "licenseDetails": {  
            "state": "Activated",  
            "target": "Windows Server 2016",  
            "Edition": "Datacenter",  
            "Type": "pCore",  
            "Processors": 12  
        }  
    }  
}

Als u een licentie wilt verwijderen, voert u de volgende opdracht uit:

DELETE  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview
  • Last updated on