다음을 통해 공유


Set-AzureRMVMDiagnosticsExtension

가상 머신에서 Azure 진단 확장을 구성합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

Set-AzureRMVMDiagnosticsExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-DiagnosticsConfigurationPath] <String>
   [[-StorageAccountName] <String>]
   [[-StorageAccountKey] <String>]
   [[-StorageAccountEndpoint] <String>]
   [[-StorageContext] <IStorageContext>]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-TypeHandlerVersion] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzureRmVMDiagnosticsExtension cmdlet은 가상 머신에서 Azure 진단 확장을 구성합니다.

예제

예제 1: 진단 구성 파일에 지정된 스토리지 계정을 사용하여 진단 사용

PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"

이 명령은 진단 구성 파일을 사용하여 진단을 사용하도록 설정합니다. 파일 diagnostics_publicconfig.xml 진단 데이터를 보낼 스토리지 계정의 이름을 포함하여 진단 확장에 대한 공용 XML 구성을 포함합니다. 진단 스토리지 계정은 가상 머신과 동일한 구독에 있어야 합니다.

예제 2: 스토리지 계정 이름을 사용하여 진단 사용

PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"

이 명령은 스토리지 계정 이름을 사용하여 진단을 사용하도록 설정합니다. 진단 구성에서 스토리지 계정 이름을 지정하지 않거나 구성 파일에 지정된 진단 스토리지 계정 이름을 재정의하려면 StorageAccountName 매개 변수를 사용합니다. 진단 스토리지 계정은 가상 머신과 동일한 구독에 있어야 합니다.

예제 3: 스토리지 계정 이름 및 키를 사용하여 진단 사용

PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml" -StorageAccountName "MyStorageAccount" -StorageAccountKey $storage_key

이 명령은 스토리지 계정 이름 및 키를 사용하여 진단을 사용하도록 설정합니다. 진단 스토리지 계정이 가상 머신과 다른 구독에 있는 경우 이름 및 키를 명시적으로 지정하여 진단 데이터를 해당 스토리지 계정으로 보낼 수 있습니다.

매개 변수

-AutoUpgradeMinorVersion

이 cmdlet을 통해 Azure 게스트 에이전트가 확장을 최신 부 버전으로 자동으로 업데이트할 수 있는지 여부를 나타냅니다.

형식:Boolean
Position:10
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DiagnosticsConfigurationPath

구성 파일의 경로를 지정합니다.

형식:String
Position:2
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Location

가상 머신의 위치를 지정합니다.

형식:String
Position:7
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

확장의 이름을 지정합니다.

형식:String
별칭:ExtensionName
Position:8
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceGroupName

가상 머신의 리소스 그룹의 이름을 지정합니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StorageAccountEndpoint

스토리지 계정 엔드포인트를 지정합니다.

형식:String
Position:5
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StorageAccountKey

스토리지 계정 키를 지정합니다.

형식:String
Position:4
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StorageAccountName

스토리지 계정 이름을 지정합니다.

형식:String
Position:3
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StorageContext

Azure Storage 컨텍스트를 지정합니다.

형식:IStorageContext
Position:6
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TypeHandlerVersion

이 가상 머신에 사용할 확장 버전을 지정합니다. 버전을 가져오려면 PublisherName 매개 변수에 대한 Microsoft.Compute 값과 Type 매개 변수에 대한 VMAccessAgent 값을 사용하여 Get-AzureRmVMExtensionImage cmdlet을 실행합니다.

형식:String
별칭:HandlerVersion, Version
Position:9
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-VMName

이 cmdlet이 작동하는 가상 머신의 이름을 지정합니다.

형식:String
별칭:ResourceName
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

IStorageContext

Boolean

출력

PSAzureOperationResponse