Delen via


Licenties voor uitgebreide beveiligingsupdates van Azure Arc programmatisch implementeren en beheren

Dit artikel bevat instructies voor het programmatisch inrichten en beheren van levenscyclusbewerkingen voor uitgebreide beveiligingsupdates van Windows Server 2012 en Windows Server 2012 R2 via de AZURE Arc WS2012 ESU ARM-API's.

Voor elk van de API-opdrachten die in dit artikel worden uitgelegd, moet u nauwkeurige parametergegevens invoeren voor locatie, status, editie, type en processors, afhankelijk van uw specifieke scenario.

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

Overstappen van volumelicenties

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]

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

Notitie

Voor PUT moeten alle eigenschappen worden opgegeven. Voor PATCH kan er een subset worden opgegeven.

Een licentie verwijderen

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