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
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 資源名稱 | 字串 （必要） |
| 位置 | VM 所在的區域。 | 字串 |
| 範圍 | 在與部署範圍不同的範圍建立擴充資源時，請使用 。 | 目標資源 針對 Bicep，請將此屬性設定為資源的符號名稱，以套用 擴充資源。 |
| 性能 | 來賓組態指派的屬性。 | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 上下文 | 起始客體設定指派的來源。 例如：Azure 原則 | 字串 |
| 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。
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
SQL Server 2014 VM & IIS VM
|
在 VNET 中建立 1 或 2 個 IIS Windows 2012 R2 網頁伺服器和一個後端 SQL Server 2014。 |
| 使用 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' |
| 名字 | 資源名稱 | 字串 （必要） |
| 位置 | VM 所在的區域。 | 字串 |
| 範圍 | 在與部署範圍不同的範圍建立擴充資源時，請使用 。 | 目標資源 針對 JSON，請將值設定為要套用 擴充功能資源 的資源完整名稱。 |
| 性能 | 來賓組態指派的屬性。 | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 上下文 | 起始客體設定指派的來源。 例如：Azure 原則 | 字串 |
| 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。
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
|
SQL Server 2014 VM & IIS VM
|
在 VNET 中建立 1 或 2 個 IIS Windows 2012 R2 網頁伺服器和一個後端 SQL Server 2014。 |
| 使用 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” |
| 名字 | 資源名稱 | 字串 （必要） |
| 位置 | VM 所在的區域。 | 字串 |
| parent_id | 要套用此延伸模組資源之資源的標識碼。 | 字串 （必要） |
| 性能 | 來賓組態指派的屬性。 | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 上下文 | 起始客體設定指派的來源。 例如：Azure 原則 | 字串 |
| 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。