Microsoft.GuestConfiguration guestConfigurationAssignments

Bicep リソース定義

guestConfigurationAssignments リソースの種類は 拡張機能リソースであり、別のリソースに適用できることを意味します。

このリソースの プロパティを scope 使用して、このリソースのスコープを設定します。 「Bicep で拡張機能リソースのスコープを設定する」を参照してください。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.GuestConfiguration/guestConfigurationAssignments リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25' = {
  name: 'string'
  location: 'string'
  scope: resourceSymbolicName
  properties: {
    context: 'string'
    guestConfiguration: {
      assignmentType: 'string'
      configurationParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      configurationProtectedParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      contentHash: 'string'
      contentUri: 'string'
      kind: 'DSC'
      name: 'string'
      version: 'string'
    }
    latestAssignmentReport: {
      assignment: {
        configuration: {}
      }
      resources: [
        {
          reasons: [
            {
            }
          ]
        }
      ]
      vm: {}
    }
    vmssVMList: [
      {
      }
    ]
  }
}

プロパティの値

guestConfigurationAssignments

名前 説明
name リソース名 string (必須)
location VM が配置されているリージョン。 string
scope デプロイ スコープとは異なるスコープで拡張機能リソースを作成する場合に使用します。 ターゲット リソース

Bicep の場合は、このプロパティをリソースのシンボリック名に設定して 、拡張機能リソースを適用します。
properties ゲスト構成割り当てのプロパティ。 GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

名前 説明
context ゲスト構成の割り当てを開始したソース。 例: Azure Policy string
guestConfiguration 割り当てるゲスト構成。 GuestConfigurationNavigation
latestAssignmentReport 最後に報告されたゲスト構成の割り当てレポート。 AssignmentReport
vmssVMList VMSS の VM コンプライアンス データの一覧 VmssvmInfo[]

GuestConfigurationNavigation

名前 説明
assignmentType 構成の割り当ての種類と実行を指定します。 使用できる値は、Audit、DeployAndAutoCorrect、ApplyAndAutoCorrect、ApplyAndMonitor です。 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'Audit'
'DeployAndAutoCorrect'
configurationParameter ゲスト構成の構成パラメーター。 ConfigurationParameter[]
configurationProtectedParameter ゲスト構成の保護された構成パラメーター。 ConfigurationParameter[]
contentHash ゲスト構成パッケージと構成パラメーターの結合ハッシュ。 string
contentUri ゲスト構成パッケージがアップロードされるストレージの URI。 string
kind ゲスト構成の種類。 例: DSC 'DSC'
name ゲスト構成の名前。 string
version ゲスト構成のバージョン。 string

ConfigurationParameter

名前 説明
name 構成パラメーターの名前。 string
value 構成パラメーターの値。 string

AssignmentReport

名前 説明
割り当て ゲスト構成割り当ての構成の詳細。 AssignmentInfo
resources ゲスト構成の割り当てコンプライアンスがチェックされるリソースの一覧。 AssignmentReportResource[]
vm VM に関する情報。 VMInfo

AssignmentInfo

名前 説明
configuration 構成に関する情報。 ConfigurationInfo

ConfigurationInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

AssignmentReportResource

名前 説明
理由 リソースのコンプライアンス理由と理由コード。 AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

VMInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

VmssvmInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
Azure セキュリティで保護されたベースラインを使用した Windows VM

Azure へのデプロイ
テンプレートは、パブリック IP アドレスを使用して、新しい仮想ネットワークで Windows Server を実行している仮想マシンを作成します。 マシンがデプロイされると、ゲスト構成拡張機能がインストールされ、Windows Server 用の Azure セキュリティで保護されたベースラインが適用されます。 マシンの構成がずれている場合は、テンプレートをもう一度デプロイして設定を再適用できます。

ARM テンプレート リソース定義

guestConfigurationAssignments リソースの種類は 拡張機能リソースであり、別のリソースに適用できることを意味します。

このリソースの スコープを scope 設定するには、このリソースの プロパティを使用します。 「ARM テンプレートで拡張機能リソースのスコープを設定する」を参照してください。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.GuestConfiguration/guestConfigurationAssignments リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
  "apiVersion": "2022-01-25",
  "name": "string",
  "location": "string",
  "scope": "string",
  "properties": {
    "context": "string",
    "guestConfiguration": {
      "assignmentType": "string",
      "configurationParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "configurationProtectedParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "contentHash": "string",
      "contentUri": "string",
      "kind": "DSC",
      "name": "string",
      "version": "string"
    },
    "latestAssignmentReport": {
      "assignment": {
        "configuration": {}
      },
      "resources": [
        {
          "reasons": [
            {
            }
          ]
        }
      ],
      "vm": {}
    },
    "vmssVMList": [
      {
      }
    ]
  }
}

プロパティの値

guestConfigurationAssignments

名前 説明
type リソースの種類 'Microsoft.GuestConfiguration/guestConfigurationAssignments'
apiVersion リソース API のバージョン '2022-01-25'
name リソース名 string (必須)
location VM が配置されているリージョン。 string
scope デプロイ スコープとは異なるスコープで拡張機能リソースを作成する場合に使用します。 ターゲット リソース

JSON の場合は、 拡張 リソースを適用するリソースの完全な名前に値を設定します。
properties ゲスト構成割り当てのプロパティ。 GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

名前 説明
context ゲスト構成の割り当てを開始したソース。 例: Azure Policy string
guestConfiguration 割り当てるゲスト構成。 GuestConfigurationNavigation
latestAssignmentReport 最後に報告されたゲスト構成の割り当てレポート。 AssignmentReport
vmssVMList VMSS の VM コンプライアンス データの一覧 VmssvmInfo[]

GuestConfigurationNavigation

名前 説明
assignmentType 構成の割り当ての種類と実行を指定します。 使用できる値は、Audit、DeployAndAutoCorrect、ApplyAndAutoCorrect、ApplyAndMonitor です。 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'Audit'
'DeployAndAutoCorrect'
configurationParameter ゲスト構成の構成パラメーター。 ConfigurationParameter[]
configurationProtectedParameter ゲスト構成の保護された構成パラメーター。 ConfigurationParameter[]
contentHash ゲスト構成パッケージと構成パラメーターの結合ハッシュ。 string
contentUri ゲスト構成パッケージがアップロードされるストレージの URI。 string
kind ゲスト構成の種類。 例: DSC 'DSC'
name ゲスト構成の名前。 string
version ゲスト構成のバージョン。 string

ConfigurationParameter

名前 説明
name 構成パラメーターの名前。 string
value 構成パラメーターの値。 string

AssignmentReport

名前 説明
割り当て ゲスト構成割り当ての構成の詳細。 AssignmentInfo
resources ゲスト構成の割り当てコンプライアンスがチェックされるリソースの一覧。 AssignmentReportResource[]
vm VM に関する情報。 VMInfo

AssignmentInfo

名前 説明
configuration 構成に関する情報。 ConfigurationInfo

ConfigurationInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

AssignmentReportResource

名前 説明
理由 リソースのコンプライアンス理由と理由コード。 AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

VMInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

VmssvmInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
Azure セキュリティで保護されたベースラインを使用した Windows VM

Azure へのデプロイ
テンプレートは、パブリック IP アドレスを使用して、新しい仮想ネットワークで Windows Server を実行する仮想マシンを作成します。 マシンがデプロイされると、ゲスト構成拡張機能がインストールされ、Windows Server 用の Azure セキュリティで保護されたベースラインが適用されます。 マシンの構成がずれている場合は、テンプレートをもう一度デプロイして設定を再適用できます。

Terraform (AzAPI プロバイダー) リソース定義

guestConfigurationAssignments リソースの種類は 拡張機能リソースであり、別のリソースに適用できることを意味します。

このリソースの プロパティを parent_id 使用して、このリソースのスコープを設定します。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.GuestConfiguration/guestConfigurationAssignments リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25"
  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"
          }
        ]
        contentHash = "string"
        contentUri = "string"
        kind = "DSC"
        name = "string"
        version = "string"
      }
      latestAssignmentReport = {
        assignment = {
          configuration = {}
        }
        resources = [
          {
            reasons = [
              {
              }
            ]
          }
        ]
        vm = {}
      }
      vmssVMList = [
        {
        }
      ]
    }
  })
}

プロパティの値

guestConfigurationAssignments

名前 説明
type リソースの種類 "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25"
name リソース名 string (必須)
location VM が配置されているリージョン。 string
parent_id この拡張機能リソースを適用するリソースの ID。 string (必須)
properties ゲスト構成割り当てのプロパティ。 GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

名前 説明
context ゲスト構成の割り当てを開始したソース。 例: Azure Policy string
guestConfiguration 割り当てるゲスト構成。 GuestConfigurationNavigation
latestAssignmentReport 最後に報告されたゲスト構成の割り当てレポート。 AssignmentReport
vmssVMList VMSS の VM コンプライアンス データの一覧 VmssvmInfo[]

GuestConfigurationNavigation

名前 説明
assignmentType 構成の割り当ての種類と実行を指定します。 使用できる値は、Audit、DeployAndAutoCorrect、ApplyAndAutoCorrect、ApplyAndMonitor です。 "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"監査"
"DeployAndAutoCorrect"
configurationParameter ゲスト構成の構成パラメーター。 ConfigurationParameter[]
configurationProtectedParameter ゲスト構成の保護された構成パラメーター。 ConfigurationParameter[]
contentHash ゲスト構成パッケージと構成パラメーターの結合ハッシュ。 string
contentUri ゲスト構成パッケージがアップロードされるストレージの URI。 string
kind ゲスト構成の種類。 例: DSC "DSC"
name ゲスト構成の名前。 string
version ゲスト構成のバージョン。 string

ConfigurationParameter

名前 説明
name 構成パラメーターの名前。 string
value 構成パラメーターの値。 string

AssignmentReport

名前 説明
割り当て ゲスト構成割り当ての構成の詳細。 AssignmentInfo
resources ゲスト構成の割り当てコンプライアンスがチェックされるリソースの一覧。 AssignmentReportResource[]
vm VM に関する情報。 VMInfo

AssignmentInfo

名前 説明
configuration 構成に関する情報。 ConfigurationInfo

ConfigurationInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

AssignmentReportResource

名前 説明
理由 リソースのコンプライアンス理由と理由コード。 AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

VMInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

VmssvmInfo

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。