Condividi tramite


Come creare un'assegnazione di configurazione del computer usando Bicep

È possibile usare Azure Bicep per distribuire le assegnazioni di configurazione del computer. Questo articolo illustra esempi per la distribuzione di configurazioni personalizzate e predefinite.

In ognuna delle sezioni seguenti, l'esempio include una proprietà type in cui il nome inizia con Microsoft.Compute/virtualMachines. Il provider di Microsoft.GuestConfiguration risorse di configurazione guest è una risorsa di estensione che deve fare riferimento a un tipo padre.

Per modificare l'esempio per altri tipi di risorse, ad esempio server abilitati per Arc, modificare il tipo padre impostando il nome del provider di risorse. Per i server abilitati per Arc, il provider di risorse è Microsoft.HybridCompute/machines.

Sostituire i campi "<>" seguenti con valori specifici dell'ambiente:

  • <vm_name>: specificare il nome della risorsa computer in cui applicare la configurazione.
  • <configuration_name>: specificare il nome della configurazione da applicare.
  • <vm_location>: specificare l'area di Azure in cui creare l'assegnazione di configurazione del computer.
  • <Url_to_Package.zip>: specificare un collegamento HTTPS al file per il .zip pacchetto di contenuto personalizzato.
  • <SHA256_hash_of_package.zip>: specificare l'hash SHA256 del file per il .zip pacchetto di contenuto personalizzato.

Assegnare una configurazione personalizzata

Nell'esempio seguente viene assegnata una configurazione personalizzata.

resource myVM 'Microsoft.Compute/virtualMachines@2021-03-01' existing = {
  name: '<vm_name>'
}

resource myConfiguration 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2020-06-25' = {
  name: '<configuration_name>'
  scope: myVM
  location: resourceGroup().location
  properties: {
    guestConfiguration: {
      name: '<configuration_name>'
      contentUri: '<Url_to_Package.zip>'
      contentHash: '<SHA256_hash_of_package.zip>'
      version: '1.*'
      assignmentType: 'ApplyAndMonitor'
    }
  }
}

Assegnare una configurazione predefinita

Nell'esempio seguente viene assegnata la AzureWindowBaseline configurazione predefinita.

resource myWindowsVM 'Microsoft.Compute/virtualMachines@2021-03-01' existing = {
  name: '<vm_name>'
}

resource AzureWindowsBaseline 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2020-06-25' = {
  name: 'AzureWindowsBaseline'
  scope: myWindowsVM
  location: resourceGroup().location
  properties: {
    guestConfiguration: {
      name: 'AzureWindowsBaseline'
      version: '1.*'
      assignmentType: 'ApplyAndMonitor'
      configurationParameter: [
        {
          name: 'Minimum Password Length;ExpectedValue'
          value: '16'
        }
        {
          name: 'Minimum Password Length;RemediateValue'
          value: '16'
        }
        {
          name: 'Maximum Password Age;ExpectedValue'
          value: '75'
        }
        {
          name: 'Maximum Password Age;RemediateValue'
          value: '75'
        }
      ]
    }
  }
}