Set-AzureDataDisk
Azure 가상 머신에서 기존 데이터 디스크의 호스트 캐싱을 수정합니다.
참고
이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.
Syntax
Set-AzureDataDisk
[-HostCaching] <String>
[-LUN] <Int32>
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDataDisk
[-DiskName] <String>
[-ResizedSizeInGB] <Int32>
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
Set-AzureDataDisk cmdlet은 Azure 가상 머신에서 기존 데이터 디스크의 캐시 특성을 수정합니다. LUN(논리 단위 번호)으로 업데이트할 데이터 디스크를 지정합니다.
예제
예제 1: 데이터 디스크에 대한 호스트 캐싱 수정
PS C:\> Get-AzureVM "ContosoService" | Set-AzureDataDisk -VM "VirtualMachine07" -LUN 2 -HostCaching ReadOnly | Update-AzureVM이 명령은 Get-AzureVM cmdlet을 사용하여 ContosoService라는 서비스에서 실행되는 가상 머신을 가져옵니다. 이 명령은 파이프라인 연산자를 사용하여 현재 cmdlet에 전달합니다. 이 cmdlet은 ReadOnly 호스트 캐싱을 사용하도록 VirtualMachine07이라는 가상 머신의 LUN 2에서 데이터 디스크를 설정합니다. 이 명령은 Update-AzureVM cmdlet을 사용하여 변경 내용을 반영하도록 가상 머신을 업데이트합니다.
예제 2: 가상 머신의 모든 데이터 디스크에 대한 호스트 캐싱 수정
PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Get-AzureDataDisk | Set-AzureDataDisk -HostCaching ReadWrite | Update-AzureVM이 명령은 ContosoService 클라우드 서비스에서 VirtualMachine07이라는 가상 머신에 대한 개체를 가져옵니다. 이 명령은 해당 가상 머신의 데이터 디스크를 가져오는 Get-AzureDataDisk cmdlet에 전달합니다. 그런 다음 현재 cmdlet은 각 데이터 디스크의 호스트 캐싱 모드를 ReadWrite로 설정합니다. 이 명령은 변경 내용을 반영하도록 가상 머신을 업데이트합니다.
매개 변수
-DiskName
이 cmdlet에서 수정하는 데이터 디스크 구성의 이름을 지정합니다.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostCaching
경고
4TiB 이상의 디스크에서 디스크 캐싱은 지원되지 않습니다. 여러 디스크가 VM에 연결되어 있는 경우 4TiB보다 작은 디스크는 캐싱을 지원합니다.
Azure 디스크의 캐시 설정이 변경되면 대상 디스크를 분리하고 다시 연결합니다. 운영 체제 디스크인 경우 VM이 다시 시작됩니다. 디스크 캐시 설정을 변경하기 전에 이 중단의 영향을 받을 수 있는 모든 애플리케이션/서비스를 중지합니다. 이러한 권장 사항을 따르지 않으면 데이터가 손상될 수 있습니다.
디스크의 호스트 수준 캐싱 설정을 지정합니다. 유효한 값은 다음과 같습니다.
- 없음
- 읽기 전용
- ReadWrite
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationAction
이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.
이 매개 변수에 허용되는 값은 다음과 같습니다.
- 계속
- 무시
- 문의
- SilentlyContinue
- Stop
- 일시 중단
| Type: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
정보 변수를 지정합니다.
| Type: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LUN
가상 머신의 데이터 드라이브에 대한 LUN을 지정합니다. 유효한 값은 0~15입니다.
| Type: | Int32 |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Profile
이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResizedSizeInGB
데이터 디스크의 새 크기(기가바이트)를 지정합니다. 새 크기는 현재 크기보다 커야 합니다.
| Type: | Int32 |
| Position: | 4 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
데이터 디스크에 연결된 가상 머신 개체를 지정합니다. 가상 머신 개체를 가져오려면 Get-AzureVM cmdlet을 사용합니다.
| Type: | IPersistentVM |
| Aliases: | InputObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |