다음을 통해 공유


Set-AzureOSDisk

Azure 가상 머신의 호스트 캐시 모드를 수정합니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.

Syntax

Set-AzureOSDisk
   [-HostCaching] <String>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureOSDisk
   [[-HostCaching] <String>]
   [-ResizedSizeInGB] <Int32>
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Set-AzureOSDisk cmdlet은 Azure 가상 머신의 운영 체제 디스크의 호스트 캐시 모드를 수정합니다. 지원되는 호스트 캐시 모드는 ReadOnly 및 ReadWrite입니다. 실행 중인 가상 머신에서 이 cmdlet을 실행하면 해당 가상 머신이 다시 시작됩니다.

예제

예제 1: 파이프라인을 사용하여 호스트 캐시 모드를 ReadOnly로 설정

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02" | Set-AzureOSDisk -HostCaching "ReadOnly"

이 명령은 Get-AzureVM cmdlet을 사용하여 ContosoService라는 서비스에서 VirtualMachine02 라는 가상 머신을 가져옵니다. 이 명령은 파이프라인 연산자를 사용하여 가상 머신을 현재 cmdlet에 전달합니다. 현재 cmdlet은 해당 가상 머신의 운영 체제 디스크의 호스트 캐시 모드를 ReadOnly로 설정합니다.

예제 2: 호스트 캐시 모드를 ReadWrite로 설정

PS C:\> $VM = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine02"
PS C:\> Set-AzureOSDisk "ReadWrite" -VM $myVM2

첫 번째 명령은 ContosoService라는 서비스에서 VirtualMachine02라는 가상 머신을 가져온 다음 변수에 저장합니다.

두 번째 명령은 해당 가상 머신의 운영 체제 디스크의 호스트 캐시 모드를 ReadWrite로 설정합니다.

매개 변수

-HostCaching

운영 체제 디스크의 호스트 캐시 특성을 지정합니다. 유효한 값은 다음과 같습니다.

  • 읽기 전용
  • 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

-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:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

이 cmdlet이 운영 체제 디스크를 수정하는 가상 머신을 지정합니다. 가상 머신 개체를 가져오려면 Get-AzureVM cmdlet을 사용합니다.

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False