Microsoft.GuestConfiguration guestConfigurationAssignments
Bicep-resursdefinition
Resurstypen guestConfigurationAssignments är en tilläggsresurs, vilket innebär att du kan tillämpa den på en annan resurs.
Använd egenskapen för scope den här resursen för att ange omfånget för den här resursen. Se Ange omfång för tilläggsresurser i Bicep.
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.GuestConfiguration/guestConfigurationAssignments-resurs lägger du till följande Bicep i mallen.
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: [
{
}
]
}
}
Egenskapsvärden
guestConfigurationAssignments
| Name | Beskrivning | Värde |
|---|---|---|
| name | Resursnamnet | sträng (krävs) |
| location | Region där den virtuella datorn finns. | sträng |
| omfång | Använd när du skapar en tilläggsresurs i ett annat omfång än distributionsomfånget. | Målresurs För Bicep anger du den här egenskapen till det symboliska namnet på resursen för att tillämpa tilläggsresursen. |
| properties | Egenskaper för gästkonfigurationstilldelningen. | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
| Name | Beskrivning | Värde |
|---|---|---|
| Sammanhang | Källan som initierade gästkonfigurationstilldelningen. Ex: Azure Policy | sträng |
| guestConfiguration | Den gästkonfiguration som ska tilldelas. | GuestConfigurationNavigation |
| latestAssignmentReport | Senast rapporterad rapport om gästkonfigurationstilldelning. | Tilldelningsrapport |
| vmssVMList | Listan över VM-efterlevnadsdata för VMSS | VmssvmInfo[] |
GuestConfigurationNavigation
| Name | Beskrivning | Värde |
|---|---|---|
| assignmentType | Anger tilldelningstyp och körning av konfigurationen. Möjliga värden är Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect och ApplyAndMonitor. | "ApplyAndAutoCorrect" "ApplyAndMonitor" "Granskning" "DeployAndAutoCorrect" |
| configurationParameter | Konfigurationsparametrarna för gästkonfigurationen. | ConfigurationParameter[] |
| configurationProtectedParameter | De skyddade konfigurationsparametrarna för gästkonfigurationen. | ConfigurationParameter[] |
| contentHash | Kombinerad hash för gästkonfigurationspaketet och konfigurationsparametrarna. | sträng |
| contentUri | Uri för lagringen där gästkonfigurationspaketet laddas upp. | sträng |
| Typ | Typ av gästkonfiguration. Till exempel:DSC | "DSC" |
| name | Namnet på gästkonfigurationen. | sträng |
| version | Version av gästkonfigurationen. | sträng |
ConfigurationParameter
| Name | Beskrivning | Värde |
|---|---|---|
| name | Namnet på konfigurationsparametern. | sträng |
| värde | Värdet för konfigurationsparametern. | sträng |
Tilldelningsrapport
| Name | Beskrivning | Värde |
|---|---|---|
| Tilldelning | Konfigurationsinformation för gästkonfigurationstilldelningen. | AssignmentInfo |
| resources | Listan över resurser som gästkonfigurationstilldelningens kompatibilitet är markerad för. | AssignmentReportResource[] |
| vm | Information om den virtuella datorn. | VMInfo |
AssignmentInfo
| Name | Beskrivning | Värde |
|---|---|---|
| konfiguration | Information om konfigurationen. | ConfigurationInfo |
ConfigurationInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
AssignmentReportResource
| Name | Beskrivning | Värde |
|---|---|---|
| Skäl | Kompatibilitetsorsak och orsakskod för en resurs. | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
VMInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
VmssvmInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
Snabbstartsmallar
Följande snabbstartsmallar distribuerar den här resurstypen.
| Mall | Description |
|---|---|
Virtuell Windows-dator med säker Azure-baslinje |
Mallen skapar en virtuell dator som kör Windows Server i ett nytt virtuellt nätverk med en offentlig IP-adress. När datorn har distribuerats installeras gästkonfigurationstillägget och Azures säkra baslinje för Windows Server tillämpas. Om konfigurationen av datorerna avviker kan du tillämpa inställningarna igen genom att distribuera mallen igen. |
Resursdefinition för ARM-mall
Resurstypen guestConfigurationAssignments är en tilläggsresurs, vilket innebär att du kan tillämpa den på en annan resurs.
Använd egenskapen för den scope här resursen för att ange omfånget för den här resursen. Se Ange omfång för tilläggsresurser i ARM-mallar.
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.GuestConfiguration/guestConfigurationAssignments-resurs lägger du till följande JSON i mallen.
{
"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": [
{
}
]
}
}
Egenskapsvärden
guestConfigurationAssignments
| Name | Beskrivning | Värde |
|---|---|---|
| typ | Resurstypen | "Microsoft.GuestConfiguration/guestConfigurationAssignments" |
| apiVersion | Resurs-API-versionen | '2022-01-25' |
| name | Resursnamnet | sträng (krävs) |
| location | Region där den virtuella datorn finns. | sträng |
| omfång | Använd när du skapar en tilläggsresurs i ett omfång som skiljer sig från distributionsomfånget. | Målresurs För JSON anger du värdet till det fullständiga namnet på resursen som tilläggsresursen ska tillämpas på. |
| properties | Egenskaper för gästkonfigurationstilldelningen. | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
| Name | Beskrivning | Värde |
|---|---|---|
| Sammanhang | Källan som initierade gästkonfigurationstilldelningen. Exempel: Azure Policy | sträng |
| guestConfiguration | Gästkonfigurationen som ska tilldelas. | GuestConfigurationNavigation |
| latestAssignmentReport | Senast rapporterad rapport om gästkonfigurationstilldelning. | Tilldelningsrapport |
| vmssVMList | Listan över VM-efterlevnadsdata för VMSS | VmssvmInfo[] |
GuestConfigurationNavigation
| Name | Beskrivning | Värde |
|---|---|---|
| assignmentType | Anger tilldelningstyp och körning av konfigurationen. Möjliga värden är Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect och ApplyAndMonitor. | "ApplyAndAutoCorrect" "ApplyAndMonitor" "Granskning" "DeployAndAutoCorrect" |
| configurationParameter | Konfigurationsparametrarna för gästkonfigurationen. | ConfigurationParameter[] |
| configurationProtectedParameter | De skyddade konfigurationsparametrarna för gästkonfigurationen. | ConfigurationParameter[] |
| contentHash | Kombinerad hash för gästkonfigurationspaketet och konfigurationsparametrarna. | sträng |
| contentUri | Uri för lagringen där gästkonfigurationspaketet laddas upp. | sträng |
| Typ | Typ av gästkonfiguration. Till exempel:DSC | "DSC" |
| name | Namnet på gästkonfigurationen. | sträng |
| version | Version av gästkonfigurationen. | sträng |
ConfigurationParameter
| Name | Beskrivning | Värde |
|---|---|---|
| name | Namnet på konfigurationsparametern. | sträng |
| värde | Värdet för konfigurationsparametern. | sträng |
Tilldelningsrapport
| Name | Beskrivning | Värde |
|---|---|---|
| Tilldelning | Konfigurationsinformation för gästkonfigurationstilldelningen. | AssignmentInfo |
| resources | Listan över resurser som gästkonfigurationstilldelningens kompatibilitet är markerad för. | AssignmentReportResource[] |
| vm | Information om den virtuella datorn. | VMInfo |
AssignmentInfo
| Name | Beskrivning | Värde |
|---|---|---|
| konfiguration | Information om konfigurationen. | ConfigurationInfo |
ConfigurationInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
AssignmentReportResource
| Name | Beskrivning | Värde |
|---|---|---|
| Skäl | Kompatibilitetsorsak och orsakskod för en resurs. | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
VMInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
VmssvmInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
Snabbstartsmallar
Följande snabbstartsmallar distribuerar den här resurstypen.
| Mall | Description |
|---|---|
| Virtuell Windows-dator med säker Azure-baslinje |
Mallen skapar en virtuell dator som kör Windows Server i ett nytt virtuellt nätverk med en offentlig IP-adress. När datorn har distribuerats installeras gästkonfigurationstillägget och Azures säkra baslinje för Windows Server tillämpas. Om konfigurationen av datorerna avviker kan du tillämpa inställningarna igen genom att distribuera mallen igen. |
Resursdefinition för Terraform (AzAPI-provider)
Resurstypen guestConfigurationAssignments är en tilläggsresurs, vilket innebär att du kan tillämpa den på en annan resurs.
Använd egenskapen för den parent_id här resursen för att ange omfånget för den här resursen.
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.GuestConfiguration/guestConfigurationAssignments-resurs lägger du till följande Terraform i mallen.
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 = [
{
}
]
}
})
}
Egenskapsvärden
guestConfigurationAssignments
| Name | Beskrivning | Värde |
|---|---|---|
| typ | Resurstypen | "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25" |
| name | Resursnamnet | sträng (krävs) |
| location | Region där den virtuella datorn finns. | sträng |
| parent_id | ID för resursen som tilläggsresursen ska tillämpas på. | sträng (krävs) |
| properties | Egenskaper för gästkonfigurationstilldelningen. | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
| Name | Beskrivning | Värde |
|---|---|---|
| Sammanhang | Källan som initierade gästkonfigurationstilldelningen. Exempel: Azure Policy | sträng |
| guestConfiguration | Gästkonfigurationen som ska tilldelas. | GuestConfigurationNavigation |
| latestAssignmentReport | Senast rapporterad rapport om gästkonfigurationstilldelning. | Tilldelningsrapport |
| vmssVMList | Listan över VM-efterlevnadsdata för VMSS | VmssvmInfo[] |
GuestConfigurationNavigation
| Name | Beskrivning | Värde |
|---|---|---|
| assignmentType | Anger tilldelningstyp och körning av konfigurationen. Möjliga värden är Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect och ApplyAndMonitor. | "ApplyAndAutoCorrect" "ApplyAndMonitor" "Granska" "DeployAndAutoCorrect" |
| configurationParameter | Konfigurationsparametrarna för gästkonfigurationen. | ConfigurationParameter[] |
| configurationProtectedParameter | De skyddade konfigurationsparametrarna för gästkonfigurationen. | ConfigurationParameter[] |
| contentHash | Kombinerad hash för gästkonfigurationspaketet och konfigurationsparametrarna. | sträng |
| contentUri | Uri för lagringen där gästkonfigurationspaketet laddas upp. | sträng |
| Typ | Typ av gästkonfiguration. Till exempel:DSC | "DSC" |
| name | Namnet på gästkonfigurationen. | sträng |
| version | Version av gästkonfigurationen. | sträng |
ConfigurationParameter
| Name | Beskrivning | Värde |
|---|---|---|
| name | Namnet på konfigurationsparametern. | sträng |
| värde | Värdet för konfigurationsparametern. | sträng |
Tilldelningsrapport
| Name | Beskrivning | Värde |
|---|---|---|
| Tilldelning | Konfigurationsinformation för gästkonfigurationstilldelningen. | AssignmentInfo |
| resources | Listan över resurser som gästkonfigurationstilldelningens kompatibilitet är markerad för. | AssignmentReportResource[] |
| vm | Information om den virtuella datorn. | VMInfo |
AssignmentInfo
| Name | Beskrivning | Värde |
|---|---|---|
| konfiguration | Information om konfigurationen. | ConfigurationInfo |
ConfigurationInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
AssignmentReportResource
| Name | Beskrivning | Värde |
|---|---|---|
| Skäl | Kompatibilitetsorsak och orsakskod för en resurs. | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
VMInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
VmssvmInfo
Det här objektet innehåller inga egenskaper som ska anges under distributionen. Alla egenskaper är ReadOnly.
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för