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 |