다음을 통해 공유


Microsoft.GuestConfiguration guestConfigurationAssignments 2021-01-25

Bicep 리소스 정의

guestConfigurationAssignments 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.GuestConfiguration/guestConfigurationAssignments 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2021-01-25' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: '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: 'string'
      name: 'string'
      version: 'string'
    }
    latestAssignmentReport: {
      assignment: {
        configuration: {}
      }
      resources: [
        {
          reasons: [
            {}
          ]
        }
      ]
      vm: {}
    }
    vmssVMList: [
      {}
    ]
  }
}

속성 값

AssignmentInfo

이름 묘사
구성 구성에 대한 정보입니다. configurationInfo

AssignmentReport

이름 묘사
숙제 게스트 구성 할당의 구성 세부 정보입니다. AssignmentInfo
리소스 게스트 구성 할당 준수를 검사할 리소스 목록입니다. AssignmentReportResource[]
vm VM에 대한 정보입니다. VMInfo

AssignmentReportResource

이름 묘사
이유 리소스에 대한 규정 준수 이유 및 이유 코드입니다. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

이름 묘사

ConfigurationInfo

이름 묘사

ConfigurationParameter

이름 묘사
이름 구성 매개 변수의 이름입니다. 문자열
구성 매개 변수의 값입니다. 문자열

ConfigurationSetting

이름 묘사
actionAfterReboot 구성을 애플리케이션하는 동안 다시 부팅한 후에 발생하는 동작을 지정합니다. 가능한 값은 ContinueConfiguration 및 StopConfiguration입니다. 'ContinueConfiguration'
'StopConfiguration'
allowModuleOverwrite true이면 끌어오기 서비스에서 다운로드한 새 구성이 대상 노드의 이전 구성을 덮어쓸 수 있습니다. 그렇지 않으면 false입니다. bool
configurationMode LCM(로컬 구성 관리자)이 실제로 대상 노드에 구성을 적용하는 방법을 지정합니다. 가능한 값은 ApplyOnly, ApplyAndMonitor 및 ApplyAndAutoCorrect입니다. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'ApplyOnly'
configurationModeFrequencyMins 현재 구성을 검사하고 적용하는 빈도(분)입니다. ConfigurationMode 속성이 ApplyOnly로 설정된 경우 이 속성은 무시됩니다. 기본값은 15입니다. int
rebootIfNeeded 다시 부팅해야 하는 구성이 적용된 후 노드를 자동으로 다시 부팅하려면 이 값을 true로 설정합니다. 그렇지 않으면 필요한 구성에 대해 노드를 수동으로 다시 부팅해야 합니다. 기본값은 false입니다. 다시 부팅 조건이 DSC 이외의 항목(예: Windows Installer)에 의해 적용될 때 이 설정을 사용하려면 이 설정을 xPendingReboot 모듈과 결합합니다. bool
refreshFrequencyMins LCM이 풀 서비스를 검사하여 업데이트된 구성을 가져오는 시간 간격(분)입니다. LCM이 끌어오기 모드로 구성되지 않은 경우 이 값은 무시됩니다. 기본값은 30입니다. int

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[]
configurationSetting 게스트 구성에 대한 구성 설정입니다. ConfigurationSetting
contentHash 게스트 구성 패키지 및 구성 매개 변수의 결합된 해시입니다. 문자열
contentUri 게스트 구성 패키지가 업로드되는 스토리지의 URI입니다. 문자열
종류 게스트 구성의 종류입니다. 예: DSC 'DSC'
이름 게스트 구성의 이름입니다. 문자열
버전 게스트 구성의 버전입니다. 문자열

Microsoft.GuestConfiguration/guestConfigurationAssignments

이름 묘사
위치 VM이 있는 지역입니다. 문자열
이름 리소스 이름 string(필수)
속성 게스트 구성 할당의 속성입니다. GuestConfigurationAssignmentProperties
범위 배포 범위와 다른 범위에서 리소스를 만들 때 사용합니다. 확장 리소스적용하려면 이 속성을 리소스의 기호 이름으로 설정합니다.

VMInfo

이름 묘사

VmssvmInfo

이름 묘사

빠른 시작 샘플

다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.

Bicep 파일 묘사
SQL Server 2014 VM & IIS VM VNET에서 1 또는 2 IIS Windows 2012 R2 웹 서버와 하나의 백 엔드 SQL Server 2014를 만듭니다.
Azure 보안 기준 사용하여 Windows VM 템플릿은 공용 IP 주소를 사용하여 새 가상 네트워크에서 Windows Server를 실행하는 가상 머신을 만듭니다. 머신이 배포되면 게스트 구성 확장이 설치되고 Windows Server에 대한 Azure 보안 기준이 적용됩니다. 컴퓨터 구성이 드리프트되는 경우 템플릿을 다시 배포하여 설정을 다시 적용할 수 있습니다.

ARM 템플릿 리소스 정의

guestConfigurationAssignments 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.GuestConfiguration/guestConfigurationAssignments 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
  "apiVersion": "2021-01-25",
  "name": "string",
  "location": "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": "string",
      "name": "string",
      "version": "string"
    },
    "latestAssignmentReport": {
      "assignment": {
        "configuration": {
        }
      },
      "resources": [
        {
          "reasons": [
            {
            }
          ]
        }
      ],
      "vm": {
      }
    },
    "vmssVMList": [
      {
      }
    ]
  }
}

속성 값

AssignmentInfo

이름 묘사
구성 구성에 대한 정보입니다. configurationInfo

AssignmentReport

이름 묘사
숙제 게스트 구성 할당의 구성 세부 정보입니다. AssignmentInfo
리소스 게스트 구성 할당 준수를 검사할 리소스 목록입니다. AssignmentReportResource[]
vm VM에 대한 정보입니다. VMInfo

AssignmentReportResource

이름 묘사
이유 리소스에 대한 규정 준수 이유 및 이유 코드입니다. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

이름 묘사

ConfigurationInfo

이름 묘사

ConfigurationParameter

이름 묘사
이름 구성 매개 변수의 이름입니다. 문자열
구성 매개 변수의 값입니다. 문자열

ConfigurationSetting

이름 묘사
actionAfterReboot 구성을 애플리케이션하는 동안 다시 부팅한 후에 발생하는 동작을 지정합니다. 가능한 값은 ContinueConfiguration 및 StopConfiguration입니다. 'ContinueConfiguration'
'StopConfiguration'
allowModuleOverwrite true이면 끌어오기 서비스에서 다운로드한 새 구성이 대상 노드의 이전 구성을 덮어쓸 수 있습니다. 그렇지 않으면 false입니다. bool
configurationMode LCM(로컬 구성 관리자)이 실제로 대상 노드에 구성을 적용하는 방법을 지정합니다. 가능한 값은 ApplyOnly, ApplyAndMonitor 및 ApplyAndAutoCorrect입니다. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'ApplyOnly'
configurationModeFrequencyMins 현재 구성을 검사하고 적용하는 빈도(분)입니다. ConfigurationMode 속성이 ApplyOnly로 설정된 경우 이 속성은 무시됩니다. 기본값은 15입니다. int
rebootIfNeeded 다시 부팅해야 하는 구성이 적용된 후 노드를 자동으로 다시 부팅하려면 이 값을 true로 설정합니다. 그렇지 않으면 필요한 구성에 대해 노드를 수동으로 다시 부팅해야 합니다. 기본값은 false입니다. 다시 부팅 조건이 DSC 이외의 항목(예: Windows Installer)에 의해 적용될 때 이 설정을 사용하려면 이 설정을 xPendingReboot 모듈과 결합합니다. bool
refreshFrequencyMins LCM이 풀 서비스를 검사하여 업데이트된 구성을 가져오는 시간 간격(분)입니다. LCM이 끌어오기 모드로 구성되지 않은 경우 이 값은 무시됩니다. 기본값은 30입니다. int

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[]
configurationSetting 게스트 구성에 대한 구성 설정입니다. ConfigurationSetting
contentHash 게스트 구성 패키지 및 구성 매개 변수의 결합된 해시입니다. 문자열
contentUri 게스트 구성 패키지가 업로드되는 스토리지의 URI입니다. 문자열
종류 게스트 구성의 종류입니다. 예: DSC 'DSC'
이름 게스트 구성의 이름입니다. 문자열
버전 게스트 구성의 버전입니다. 문자열

Microsoft.GuestConfiguration/guestConfigurationAssignments

이름 묘사
apiVersion api 버전 '2021-01-25'
위치 VM이 있는 지역입니다. 문자열
이름 리소스 이름 string(필수)
속성 게스트 구성 할당의 속성입니다. GuestConfigurationAssignmentProperties
리소스 종류 'Microsoft.GuestConfiguration/guestConfigurationAssignments'

VMInfo

이름 묘사

VmssvmInfo

이름 묘사

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛 묘사
SQL Server 2014 VM & IIS VM

Azure
배포
VNET에서 1 또는 2 IIS Windows 2012 R2 웹 서버와 하나의 백 엔드 SQL Server 2014를 만듭니다.
Azure 보안 기준 사용하여 Windows VM

Azure
배포
템플릿은 공용 IP 주소를 사용하여 새 가상 네트워크에서 Windows Server를 실행하는 가상 머신을 만듭니다. 머신이 배포되면 게스트 구성 확장이 설치되고 Windows Server에 대한 Azure 보안 기준이 적용됩니다. 컴퓨터 구성이 드리프트되는 경우 템플릿을 다시 배포하여 설정을 다시 적용할 수 있습니다.

Terraform(AzAPI 공급자) 리소스 정의

guestConfigurationAssignments 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.GuestConfiguration/guestConfigurationAssignments 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

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

속성 값

AssignmentInfo

이름 묘사
구성 구성에 대한 정보입니다. configurationInfo

AssignmentReport

이름 묘사
숙제 게스트 구성 할당의 구성 세부 정보입니다. AssignmentInfo
리소스 게스트 구성 할당 준수를 검사할 리소스 목록입니다. AssignmentReportResource[]
vm VM에 대한 정보입니다. VMInfo

AssignmentReportResource

이름 묘사
이유 리소스에 대한 규정 준수 이유 및 이유 코드입니다. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

이름 묘사

ConfigurationInfo

이름 묘사

ConfigurationParameter

이름 묘사
이름 구성 매개 변수의 이름입니다. 문자열
구성 매개 변수의 값입니다. 문자열

ConfigurationSetting

이름 묘사
actionAfterReboot 구성을 애플리케이션하는 동안 다시 부팅한 후에 발생하는 동작을 지정합니다. 가능한 값은 ContinueConfiguration 및 StopConfiguration입니다. 'ContinueConfiguration'
'StopConfiguration'
allowModuleOverwrite true이면 끌어오기 서비스에서 다운로드한 새 구성이 대상 노드의 이전 구성을 덮어쓸 수 있습니다. 그렇지 않으면 false입니다. bool
configurationMode LCM(로컬 구성 관리자)이 실제로 대상 노드에 구성을 적용하는 방법을 지정합니다. 가능한 값은 ApplyOnly, ApplyAndMonitor 및 ApplyAndAutoCorrect입니다. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'ApplyOnly'
configurationModeFrequencyMins 현재 구성을 검사하고 적용하는 빈도(분)입니다. ConfigurationMode 속성이 ApplyOnly로 설정된 경우 이 속성은 무시됩니다. 기본값은 15입니다. int
rebootIfNeeded 다시 부팅해야 하는 구성이 적용된 후 노드를 자동으로 다시 부팅하려면 이 값을 true로 설정합니다. 그렇지 않으면 필요한 구성에 대해 노드를 수동으로 다시 부팅해야 합니다. 기본값은 false입니다. 다시 부팅 조건이 DSC 이외의 항목(예: Windows Installer)에 의해 적용될 때 이 설정을 사용하려면 이 설정을 xPendingReboot 모듈과 결합합니다. bool
refreshFrequencyMins LCM이 풀 서비스를 검사하여 업데이트된 구성을 가져오는 시간 간격(분)입니다. LCM이 끌어오기 모드로 구성되지 않은 경우 이 값은 무시됩니다. 기본값은 30입니다. int

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[]
configurationSetting 게스트 구성에 대한 구성 설정입니다. ConfigurationSetting
contentHash 게스트 구성 패키지 및 구성 매개 변수의 결합된 해시입니다. 문자열
contentUri 게스트 구성 패키지가 업로드되는 스토리지의 URI입니다. 문자열
종류 게스트 구성의 종류입니다. 예: DSC 'DSC'
이름 게스트 구성의 이름입니다. 문자열
버전 게스트 구성의 버전입니다. 문자열

Microsoft.GuestConfiguration/guestConfigurationAssignments

이름 묘사
위치 VM이 있는 지역입니다. 문자열
이름 리소스 이름 string(필수)
parent_id 이 확장 리소스를 적용할 리소스의 ID입니다. string(필수)
속성 게스트 구성 할당의 속성입니다. GuestConfigurationAssignmentProperties
리소스 종류 "Microsoft.GuestConfiguration/guestConfigurationAssignments@2021-01-25"

VMInfo

이름 묘사

VmssvmInfo

이름 묘사