Bagikan melalui


Microsoft.GuestConfiguration guestConfigurationAssignments 2018-11-20

Definisi sumber daya Bicep

Jenis sumber daya guestConfigurationAssignments adalah sumber daya ekstensi , yang berarti Anda dapat menerapkannya ke sumber daya lain.

Gunakan properti scope pada sumber daya ini untuk mengatur cakupan untuk sumber daya ini. Lihat Mengatur cakupan pada sumber daya ekstensi di Bicep.

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Format sumber daya

Untuk membuat sumber daya Microsoft.GuestConfiguration/guestConfigurationAssignments, tambahkan Bicep berikut ke templat Anda.

resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-11-20' = {
  name: 'string'
  location: 'string'
  scope: resourceSymbolicName
  properties: {
    context: 'string'
    guestConfiguration: {
      assignmentType: 'string'
      configurationParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      configurationProtectedParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      configurationSetting: {
        actionAfterReboot: 'string'
        allowModuleOverwrite: bool
        configurationMode: 'string'
        configurationModeFrequencyMins: int
        rebootIfNeeded: bool
        refreshFrequencyMins: int
      }
      contentHash: 'string'
      contentUri: 'string'
      kind: 'DSC'
      name: 'string'
      version: 'string'
    }
    vmssVMList: [
      {
      }
    ]
  }
}

Nilai properti

guestConfigurationAssignments

Nama Deskripsi Nilai
Nama Nama sumber daya string (diperlukan)
tempat Wilayah tempat VM berada. tali
ruang lingkup Gunakan saat membuat sumber daya ekstensi pada cakupan yang berbeda dari cakupan penyebaran. Sumber daya target

Untuk Bicep, atur properti ini ke nama simbolis sumber daya untuk menerapkan sumber daya ekstensi .
Properti Properti penetapan konfigurasi Tamu. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Nama Deskripsi Nilai
konteks Sumber yang memulai penetapan konfigurasi tamu. Misalnya: Azure Policy tali
guestConfiguration Konfigurasi tamu yang akan ditetapkan. GuestConfigurationNavigation
vmssVMList Daftar data Kepatuhan VM untuk VMSS VmssvmInfo[]

GuestConfigurationNavigation

Nama Deskripsi Nilai
assignmentType Menentukan jenis penugasan dan eksekusi konfigurasi. Nilai yang mungkin adalah Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect, dan ApplyAndMonitor. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'Audit'
'DeployAndAutoCorrect'
configurationParameter Parameter konfigurasi untuk konfigurasi tamu. ConfigurationParameter[]
configurationProtectedParameter Parameter konfigurasi yang dilindungi untuk konfigurasi tamu. ConfigurationParameter[]
configurationSetting Pengaturan konfigurasi untuk konfigurasi tamu. ConfigurationSetting
contentHash Hash gabungan dari paket konfigurasi tamu dan parameter konfigurasi. tali
contentUri Uri penyimpanan tempat paket konfigurasi tamu diunggah. tali
jenis Jenis konfigurasi tamu. Misalnya:DSC 'DSC'
Nama Nama konfigurasi tamu. tali
versi Versi konfigurasi tamu. tali

ConfigurationParameter

Nama Deskripsi Nilai
Nama Nama parameter konfigurasi. tali
nilai Nilai parameter konfigurasi. tali

ConfigurationSetting

Nama Deskripsi Nilai
actionAfterReboot Menentukan apa yang terjadi setelah boot ulang selama aplikasi konfigurasi. Nilai yang mungkin adalah ContinueConfiguration dan StopConfiguration 'LanjutkanKonfigurasi'
'StopConfiguration'
allowModuleOverwrite Jika true - konfigurasi baru yang diunduh dari layanan penarikan diizinkan untuk menimpa yang lama pada simpul target. Jika tidak, false bool
configurationMode Menentukan bagaimana LCM(Local Configuration Manager) benar-benar menerapkan konfigurasi ke simpul target. Nilai yang mungkin adalah ApplyOnly, ApplyAndMonitor, dan ApplyAndAutoCorrect. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'ApplyOnly'
configurationModeFrequencyMins Seberapa sering, dalam menit, konfigurasi saat ini diperiksa dan diterapkan. Properti ini diabaikan jika properti ConfigurationMode diatur ke ApplyOnly. Nilai defaultnya adalah 15. Int
rebootIfNeeded Atur ini ke true untuk secara otomatis me-reboot simpul setelah konfigurasi yang memerlukan reboot diterapkan. Jika tidak, Anda harus me-reboot simpul secara manual untuk konfigurasi apa pun yang memerlukannya. Nilai defaultnya adalah false. Untuk menggunakan pengaturan ini ketika kondisi reboot diberlakukan oleh sesuatu selain DSC (seperti Windows Installer), gabungkan pengaturan ini dengan modul xPendingReboot. bool
refreshFrequencyMins Interval waktu, dalam menit, di mana LCM memeriksa layanan penarikan untuk mendapatkan konfigurasi yang diperbarui. Nilai ini diabaikan jika LCM tidak dikonfigurasi dalam mode penarikan. Nilai defaultnya adalah 30. Int

VmssvmInfo

Objek ini tidak berisi properti apa pun untuk diatur selama penyebaran. Semua properti adalah ReadOnly.

Templat mulai cepat

Templat mulai cepat berikut menyebarkan jenis sumber daya ini.

Templat Deskripsi
VM IIS & VM SQL Server 2014

Sebarkan ke Azure
Buat 1 atau 2 Server Web IIS Windows 2012 R2 dan satu ujung belakang SQL Server 2014 di VNET.
VM Windows dengan garis besar aman Azure

Sebarkan ke Azure
Templat membuat komputer virtual yang menjalankan Windows Server di jaringan virtual baru, dengan alamat IP publik. Setelah komputer disebarkan, ekstensi konfigurasi tamu diinstal dan garis besar aman Azure untuk Windows Server diterapkan. Jika konfigurasi komputer melayang, Anda dapat menerapkan kembali pengaturan dengan menyebarkan templat lagi.

Definisi sumber daya templat ARM

Jenis sumber daya guestConfigurationAssignments adalah sumber daya ekstensi , yang berarti Anda dapat menerapkannya ke sumber daya lain.

Gunakan properti scope pada sumber daya ini untuk mengatur cakupan untuk sumber daya ini. Lihat Mengatur cakupan pada sumber daya ekstensi di templat ARM.

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Format sumber daya

Untuk membuat sumber daya Microsoft.GuestConfiguration/guestConfigurationAssignments, tambahkan JSON berikut ke templat Anda.

{
  "type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
  "apiVersion": "2018-11-20",
  "name": "string",
  "location": "string",
  "scope": "string",
  "properties": {
    "context": "string",
    "guestConfiguration": {
      "assignmentType": "string",
      "configurationParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "configurationProtectedParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "configurationSetting": {
        "actionAfterReboot": "string",
        "allowModuleOverwrite": "bool",
        "configurationMode": "string",
        "configurationModeFrequencyMins": "int",
        "rebootIfNeeded": "bool",
        "refreshFrequencyMins": "int"
      },
      "contentHash": "string",
      "contentUri": "string",
      "kind": "DSC",
      "name": "string",
      "version": "string"
    },
    "vmssVMList": [
      {
      }
    ]
  }
}

Nilai properti

guestConfigurationAssignments

Nama Deskripsi Nilai
jenis Jenis sumber daya 'Microsoft.GuestConfiguration/guestConfigurationAssignments'
apiVersion Versi api sumber daya '2018-11-20'
Nama Nama sumber daya string (diperlukan)
tempat Wilayah tempat VM berada. tali
ruang lingkup Gunakan saat membuat sumber daya ekstensi pada cakupan yang berbeda dari cakupan penyebaran. Sumber daya target

Untuk JSON, atur nilai ke nama lengkap sumber daya untuk menerapkan sumber daya ekstensi .
Properti Properti penetapan konfigurasi Tamu. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Nama Deskripsi Nilai
konteks Sumber yang memulai penetapan konfigurasi tamu. Misalnya: Azure Policy tali
guestConfiguration Konfigurasi tamu yang akan ditetapkan. GuestConfigurationNavigation
vmssVMList Daftar data Kepatuhan VM untuk VMSS VmssvmInfo[]

GuestConfigurationNavigation

Nama Deskripsi Nilai
assignmentType Menentukan jenis penugasan dan eksekusi konfigurasi. Nilai yang mungkin adalah Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect, dan ApplyAndMonitor. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'Audit'
'DeployAndAutoCorrect'
configurationParameter Parameter konfigurasi untuk konfigurasi tamu. ConfigurationParameter[]
configurationProtectedParameter Parameter konfigurasi yang dilindungi untuk konfigurasi tamu. ConfigurationParameter[]
configurationSetting Pengaturan konfigurasi untuk konfigurasi tamu. ConfigurationSetting
contentHash Hash gabungan dari paket konfigurasi tamu dan parameter konfigurasi. tali
contentUri Uri penyimpanan tempat paket konfigurasi tamu diunggah. tali
jenis Jenis konfigurasi tamu. Misalnya:DSC 'DSC'
Nama Nama konfigurasi tamu. tali
versi Versi konfigurasi tamu. tali

ConfigurationParameter

Nama Deskripsi Nilai
Nama Nama parameter konfigurasi. tali
nilai Nilai parameter konfigurasi. tali

ConfigurationSetting

Nama Deskripsi Nilai
actionAfterReboot Menentukan apa yang terjadi setelah boot ulang selama aplikasi konfigurasi. Nilai yang mungkin adalah ContinueConfiguration dan StopConfiguration 'LanjutkanKonfigurasi'
'StopConfiguration'
allowModuleOverwrite Jika true - konfigurasi baru yang diunduh dari layanan penarikan diizinkan untuk menimpa yang lama pada simpul target. Jika tidak, false bool
configurationMode Menentukan bagaimana LCM(Local Configuration Manager) benar-benar menerapkan konfigurasi ke simpul target. Nilai yang mungkin adalah ApplyOnly, ApplyAndMonitor, dan ApplyAndAutoCorrect. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'ApplyOnly'
configurationModeFrequencyMins Seberapa sering, dalam menit, konfigurasi saat ini diperiksa dan diterapkan. Properti ini diabaikan jika properti ConfigurationMode diatur ke ApplyOnly. Nilai defaultnya adalah 15. Int
rebootIfNeeded Atur ini ke true untuk secara otomatis me-reboot simpul setelah konfigurasi yang memerlukan reboot diterapkan. Jika tidak, Anda harus me-reboot simpul secara manual untuk konfigurasi apa pun yang memerlukannya. Nilai defaultnya adalah false. Untuk menggunakan pengaturan ini ketika kondisi reboot diberlakukan oleh sesuatu selain DSC (seperti Windows Installer), gabungkan pengaturan ini dengan modul xPendingReboot. bool
refreshFrequencyMins Interval waktu, dalam menit, di mana LCM memeriksa layanan penarikan untuk mendapatkan konfigurasi yang diperbarui. Nilai ini diabaikan jika LCM tidak dikonfigurasi dalam mode penarikan. Nilai defaultnya adalah 30. Int

VmssvmInfo

Objek ini tidak berisi properti apa pun untuk diatur selama penyebaran. Semua properti adalah ReadOnly.

Templat mulai cepat

Templat mulai cepat berikut menyebarkan jenis sumber daya ini.

Templat Deskripsi
VM IIS & VM SQL Server 2014

Sebarkan ke Azure
Buat 1 atau 2 Server Web IIS Windows 2012 R2 dan satu ujung belakang SQL Server 2014 di VNET.
VM Windows dengan garis besar aman Azure

Sebarkan ke Azure
Templat membuat komputer virtual yang menjalankan Windows Server di jaringan virtual baru, dengan alamat IP publik. Setelah komputer disebarkan, ekstensi konfigurasi tamu diinstal dan garis besar aman Azure untuk Windows Server diterapkan. Jika konfigurasi komputer melayang, Anda dapat menerapkan kembali pengaturan dengan menyebarkan templat lagi.

Definisi sumber daya Terraform (penyedia AzAPI)

Jenis sumber daya guestConfigurationAssignments adalah sumber daya ekstensi , yang berarti Anda dapat menerapkannya ke sumber daya lain.

Gunakan properti parent_id pada sumber daya ini untuk mengatur cakupan untuk sumber daya ini.

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Format sumber daya

Untuk membuat sumber daya Microsoft.GuestConfiguration/guestConfigurationAssignments, tambahkan Terraform berikut ke templat Anda.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-11-20"
  name = "string"
  location = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      context = "string"
      guestConfiguration = {
        assignmentType = "string"
        configurationParameter = [
          {
            name = "string"
            value = "string"
          }
        ]
        configurationProtectedParameter = [
          {
            name = "string"
            value = "string"
          }
        ]
        configurationSetting = {
          actionAfterReboot = "string"
          allowModuleOverwrite = bool
          configurationMode = "string"
          configurationModeFrequencyMins = int
          rebootIfNeeded = bool
          refreshFrequencyMins = int
        }
        contentHash = "string"
        contentUri = "string"
        kind = "DSC"
        name = "string"
        version = "string"
      }
      vmssVMList = [
        {
        }
      ]
    }
  })
}

Nilai properti

guestConfigurationAssignments

Nama Deskripsi Nilai
jenis Jenis sumber daya "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-11-20"
Nama Nama sumber daya string (diperlukan)
tempat Wilayah tempat VM berada. tali
parent_id ID sumber daya untuk menerapkan sumber daya ekstensi ini. string (diperlukan)
Properti Properti penetapan konfigurasi Tamu. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Nama Deskripsi Nilai
konteks Sumber yang memulai penetapan konfigurasi tamu. Misalnya: Azure Policy tali
guestConfiguration Konfigurasi tamu yang akan ditetapkan. GuestConfigurationNavigation
vmssVMList Daftar data Kepatuhan VM untuk VMSS VmssvmInfo[]

GuestConfigurationNavigation

Nama Deskripsi Nilai
assignmentType Menentukan jenis penugasan dan eksekusi konfigurasi. Nilai yang mungkin adalah Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect, dan ApplyAndMonitor. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"Audit"
"DeployAndAutoCorrect"
configurationParameter Parameter konfigurasi untuk konfigurasi tamu. ConfigurationParameter[]
configurationProtectedParameter Parameter konfigurasi yang dilindungi untuk konfigurasi tamu. ConfigurationParameter[]
configurationSetting Pengaturan konfigurasi untuk konfigurasi tamu. ConfigurationSetting
contentHash Hash gabungan dari paket konfigurasi tamu dan parameter konfigurasi. tali
contentUri Uri penyimpanan tempat paket konfigurasi tamu diunggah. tali
jenis Jenis konfigurasi tamu. Misalnya:DSC "DSC"
Nama Nama konfigurasi tamu. tali
versi Versi konfigurasi tamu. tali

ConfigurationParameter

Nama Deskripsi Nilai
Nama Nama parameter konfigurasi. tali
nilai Nilai parameter konfigurasi. tali

ConfigurationSetting

Nama Deskripsi Nilai
actionAfterReboot Menentukan apa yang terjadi setelah boot ulang selama aplikasi konfigurasi. Nilai yang mungkin adalah ContinueConfiguration dan StopConfiguration "LanjutkanKonfigurasi"
"StopConfiguration"
allowModuleOverwrite Jika true - konfigurasi baru yang diunduh dari layanan penarikan diizinkan untuk menimpa yang lama pada simpul target. Jika tidak, false bool
configurationMode Menentukan bagaimana LCM(Local Configuration Manager) benar-benar menerapkan konfigurasi ke simpul target. Nilai yang mungkin adalah ApplyOnly, ApplyAndMonitor, dan ApplyAndAutoCorrect. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"ApplyOnly"
configurationModeFrequencyMins Seberapa sering, dalam menit, konfigurasi saat ini diperiksa dan diterapkan. Properti ini diabaikan jika properti ConfigurationMode diatur ke ApplyOnly. Nilai defaultnya adalah 15. Int
rebootIfNeeded Atur ini ke true untuk secara otomatis me-reboot simpul setelah konfigurasi yang memerlukan reboot diterapkan. Jika tidak, Anda harus me-reboot simpul secara manual untuk konfigurasi apa pun yang memerlukannya. Nilai defaultnya adalah false. Untuk menggunakan pengaturan ini ketika kondisi reboot diberlakukan oleh sesuatu selain DSC (seperti Windows Installer), gabungkan pengaturan ini dengan modul xPendingReboot. bool
refreshFrequencyMins Interval waktu, dalam menit, di mana LCM memeriksa layanan penarikan untuk mendapatkan konfigurasi yang diperbarui. Nilai ini diabaikan jika LCM tidak dikonfigurasi dalam mode penarikan. Nilai defaultnya adalah 30. Int

VmssvmInfo

Objek ini tidak berisi properti apa pun untuk diatur selama penyebaran. Semua properti adalah ReadOnly.