Microsoft.GuestConfiguration guestConfigurationAssignments 2018-11-20

아티클
12/21/2024

Bicep 리소스 정의

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

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

리소스 형식

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

resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-11-20' = {
  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'
    }
    vmssVMList: [
      {}
    ]
  }
}

속성 값

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
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
범위	배포 범위와 다른 범위에서 리소스를 만들 때 사용합니다.	확장 리소스적용하려면 이 속성을 리소스의 기호 이름으로 설정합니다.

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": "2018-11-20",
  "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"
    },
    "vmssVMList": [
      {
      }
    ]
  }
}

속성 값

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
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 버전	'2018-11-20'
위치	VM이 있는 지역입니다.	문자열
이름	리소스 이름	string(필수)
속성	게스트 구성 할당의 속성입니다.	GuestConfigurationAssignmentProperties
형	리소스 종류	'Microsoft.GuestConfiguration/guestConfigurationAssignments'

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@2018-11-20"
  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"
      }
      vmssVMList = [
        {
        }
      ]
    }
  })
}

속성 값

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
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@2018-11-20"

VmssvmInfo

이름	묘사	값

다음을 통해 공유

Microsoft.GuestConfiguration guestConfigurationAssignments 2018-11-20

Bicep 리소스 정의

리소스 형식

속성 값

ConfigurationParameter

ConfigurationSetting

GuestConfigurationAssignmentProperties

GuestConfigurationNavigation

Microsoft.GuestConfiguration/guestConfigurationAssignments

VmssvmInfo

빠른 시작 샘플

ARM 템플릿 리소스 정의

리소스 형식

속성 값

ConfigurationParameter

ConfigurationSetting

GuestConfigurationAssignmentProperties

GuestConfigurationNavigation

Microsoft.GuestConfiguration/guestConfigurationAssignments

VmssvmInfo

빠른 시작 템플릿

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

리소스 형식

속성 값

ConfigurationParameter

ConfigurationSetting

GuestConfigurationAssignmentProperties

GuestConfigurationNavigation

Microsoft.GuestConfiguration/guestConfigurationAssignments

VmssvmInfo

피드백

추가 리소스