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
名前 | 形容 | 価値 |
---|---|---|
名前 | リソース名 | string (必須) |
場所 | VM が配置されているリージョン。 | 糸 |
スコープ | デプロイ スコープとは異なるスコープで拡張機能リソースを作成する場合に使用します。 | ターゲット リソース Bicep の場合は、このプロパティをリソースのシンボリック名に設定して、拡張リソース適用します。 |
プロパティ | ゲスト構成割り当てのプロパティ。 | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
名前 | 形容 | 価値 |
---|---|---|
文脈 | ゲスト構成の割り当てを開始したソース。 例: Azure Policy | 糸 |
guestConfiguration | 割り当てるゲスト構成。 | GuestConfigurationNavigation |
latestAssignmentReport | 最後に報告されたゲスト構成の割り当てレポート。 | AssignmentReport |
vmssVMList | VMSS の VM コンプライアンス データの一覧 | VmssvmInfo[] |
GuestConfigurationNavigation
名前 | 形容 | 価値 |
---|---|---|
assignmentType | 構成の割り当ての種類と実行を指定します。 指定できる値は、Audit、DeployAndAutoCorrect、ApplyAndAutoCorrect、ApplyAndMonitor です。 | 'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Audit' 'DeployAndAutoCorrect' |
configurationParameter | ゲスト構成の構成パラメーター。 | ConfigurationParameter[] |
configurationProtectedParameter | ゲスト構成の保護された構成パラメーター。 | ConfigurationParameter[] |
contentHash | ゲスト構成パッケージと構成パラメーターの結合ハッシュ。 | 糸 |
contentUri | ゲスト構成パッケージがアップロードされるストレージの URI。 | 糸 |
種類 | ゲスト構成の種類。 例: DSC | 'DSC' |
名前 | ゲスト構成の名前。 | 糸 |
バージョン | ゲスト構成のバージョン。 | 糸 |
ConfigurationParameter
名前 | 形容 | 価値 |
---|---|---|
名前 | 構成パラメーターの名前。 | 糸 |
価値 | 構成パラメーターの値。 | 糸 |
AssignmentReport
名前 | 形容 | 価値 |
---|---|---|
割り当て | ゲスト構成割り当ての構成の詳細。 | AssignmentInfo |
リソース | ゲスト構成の割り当てコンプライアンスがチェックされるリソースの一覧。 | AssignmentReportResource[] |
vm | VM に関する情報。 | VMInfo を |
AssignmentInfo
名前 | 形容 | 価値 |
---|---|---|
構成 | 構成に関する情報。 | ConfigurationInfo |
ConfigurationInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
AssignmentReportResource
名前 | 形容 | 価値 |
---|---|---|
理由 | リソースのコンプライアンス理由と理由コード。 | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
VMInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
VmssvmInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
クイック スタート テンプレート
次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。
テンプレート | 形容 |
---|---|
IIS VM & SQL Server 2014 VM Azure にデプロイする |
VNET で 1 つまたは 2 つの IIS Windows 2012 R2 Web サーバーと 1 つのバックエンド SQL Server 2014 を作成します。 |
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
名前 | 形容 | 価値 |
---|---|---|
種類 | リソースの種類 | 'Microsoft.GuestConfiguration/guestConfigurationAssignments' |
apiVersion | リソース API のバージョン | '2022-01-25' |
名前 | リソース名 | string (必須) |
場所 | VM が配置されているリージョン。 | 糸 |
スコープ | デプロイ スコープとは異なるスコープで拡張機能リソースを作成する場合に使用します。 | ターゲット リソース JSON の場合、拡張機能リソースの を適用するリソースの完全な名前に値を設定します。 |
プロパティ | ゲスト構成割り当てのプロパティ。 | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
名前 | 形容 | 価値 |
---|---|---|
文脈 | ゲスト構成の割り当てを開始したソース。 例: Azure Policy | 糸 |
guestConfiguration | 割り当てるゲスト構成。 | GuestConfigurationNavigation |
latestAssignmentReport | 最後に報告されたゲスト構成の割り当てレポート。 | AssignmentReport |
vmssVMList | VMSS の VM コンプライアンス データの一覧 | VmssvmInfo[] |
GuestConfigurationNavigation
名前 | 形容 | 価値 |
---|---|---|
assignmentType | 構成の割り当ての種類と実行を指定します。 指定できる値は、Audit、DeployAndAutoCorrect、ApplyAndAutoCorrect、ApplyAndMonitor です。 | 'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Audit' 'DeployAndAutoCorrect' |
configurationParameter | ゲスト構成の構成パラメーター。 | ConfigurationParameter[] |
configurationProtectedParameter | ゲスト構成の保護された構成パラメーター。 | ConfigurationParameter[] |
contentHash | ゲスト構成パッケージと構成パラメーターの結合ハッシュ。 | 糸 |
contentUri | ゲスト構成パッケージがアップロードされるストレージの URI。 | 糸 |
種類 | ゲスト構成の種類。 例: DSC | 'DSC' |
名前 | ゲスト構成の名前。 | 糸 |
バージョン | ゲスト構成のバージョン。 | 糸 |
ConfigurationParameter
名前 | 形容 | 価値 |
---|---|---|
名前 | 構成パラメーターの名前。 | 糸 |
価値 | 構成パラメーターの値。 | 糸 |
AssignmentReport
名前 | 形容 | 価値 |
---|---|---|
割り当て | ゲスト構成割り当ての構成の詳細。 | AssignmentInfo |
リソース | ゲスト構成の割り当てコンプライアンスがチェックされるリソースの一覧。 | AssignmentReportResource[] |
vm | VM に関する情報。 | VMInfo を |
AssignmentInfo
名前 | 形容 | 価値 |
---|---|---|
構成 | 構成に関する情報。 | ConfigurationInfo |
ConfigurationInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
AssignmentReportResource
名前 | 形容 | 価値 |
---|---|---|
理由 | リソースのコンプライアンス理由と理由コード。 | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
VMInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
VmssvmInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
クイック スタート テンプレート
次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。
テンプレート | 形容 |
---|---|
IIS VM & SQL Server 2014 VM Azure にデプロイする |
VNET で 1 つまたは 2 つの IIS Windows 2012 R2 Web サーバーと 1 つのバックエンド SQL Server 2014 を作成します。 |
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
名前 | 形容 | 価値 |
---|---|---|
種類 | リソースの種類 | "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25" |
名前 | リソース名 | string (必須) |
場所 | VM が配置されているリージョン。 | 糸 |
parent_id | この拡張リソースを適用するリソースの ID。 | string (必須) |
プロパティ | ゲスト構成割り当てのプロパティ。 | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
名前 | 形容 | 価値 |
---|---|---|
文脈 | ゲスト構成の割り当てを開始したソース。 例: Azure Policy | 糸 |
guestConfiguration | 割り当てるゲスト構成。 | GuestConfigurationNavigation |
latestAssignmentReport | 最後に報告されたゲスト構成の割り当てレポート。 | AssignmentReport |
vmssVMList | VMSS の VM コンプライアンス データの一覧 | VmssvmInfo[] |
GuestConfigurationNavigation
名前 | 形容 | 価値 |
---|---|---|
assignmentType | 構成の割り当ての種類と実行を指定します。 指定できる値は、Audit、DeployAndAutoCorrect、ApplyAndAutoCorrect、ApplyAndMonitor です。 | "ApplyAndAutoCorrect" "ApplyAndMonitor" "Audit" "DeployAndAutoCorrect" |
configurationParameter | ゲスト構成の構成パラメーター。 | ConfigurationParameter[] |
configurationProtectedParameter | ゲスト構成の保護された構成パラメーター。 | ConfigurationParameter[] |
contentHash | ゲスト構成パッケージと構成パラメーターの結合ハッシュ。 | 糸 |
contentUri | ゲスト構成パッケージがアップロードされるストレージの URI。 | 糸 |
種類 | ゲスト構成の種類。 例: DSC | "DSC" |
名前 | ゲスト構成の名前。 | 糸 |
バージョン | ゲスト構成のバージョン。 | 糸 |
ConfigurationParameter
名前 | 形容 | 価値 |
---|---|---|
名前 | 構成パラメーターの名前。 | 糸 |
価値 | 構成パラメーターの値。 | 糸 |
AssignmentReport
名前 | 形容 | 価値 |
---|---|---|
割り当て | ゲスト構成割り当ての構成の詳細。 | AssignmentInfo |
リソース | ゲスト構成の割り当てコンプライアンスがチェックされるリソースの一覧。 | AssignmentReportResource[] |
vm | VM に関する情報。 | VMInfo を |
AssignmentInfo
名前 | 形容 | 価値 |
---|---|---|
構成 | 構成に関する情報。 | ConfigurationInfo |
ConfigurationInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
AssignmentReportResource
名前 | 形容 | 価値 |
---|---|---|
理由 | リソースのコンプライアンス理由と理由コード。 | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
VMInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
VmssvmInfo
このオブジェクトには、配置時に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。