다음을 통해 공유


Set-AzVMDiagnosticsExtension

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

구문

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

Description

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

예제

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

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"

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

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

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"

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

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

Set-AzVMDiagnosticsExtension -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
별칭:AzContext, 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

-NoWait

작업을 시작하고 작업이 완료되기 전에 즉시 반환합니다. 작업이 성공적으로 완료되었는지 확인하려면 다른 메커니즘을 사용합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용: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-AzVMExtensionImage 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