Set-AzureRmVMOSDisk
가상 머신에서 운영 체제 디스크 속성을 설정합니다.
Warning
AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.
AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.
구문
Set-AzureRmVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-Windows]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-Windows]
[-DiskEncryptionKeyUrl] <String>
[-DiskEncryptionKeyVaultId] <String>
[[-KeyEncryptionKeyUrl] <String>]
[[-KeyEncryptionKeyVaultId] <String>]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-Linux]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOSDisk
[-VM] <PSVirtualMachine>
[[-Name] <String>]
[[-VhdUri] <String>]
[[-Caching] <CachingTypes>]
[[-SourceImageUri] <String>]
[[-CreateOption] <String>]
[-Linux]
[-DiskEncryptionKeyUrl] <String>
[-DiskEncryptionKeyVaultId] <String>
[[-KeyEncryptionKeyUrl] <String>]
[[-KeyEncryptionKeyVaultId] <String>]
[-DiskSizeInGB <Int32>]
[-ManagedDiskId <String>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DiffDiskSetting <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Set-AzureRmVMOSDisk cmdlet은 가상 머신에서 운영 체제 디스크 속성을 설정합니다.
예제
예제 1: 플랫폼 이미지에서 가상 머신의 속성 설정
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
PS C:\> Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential)
PS C:\> $VirtualMachine = Set-AzureRmVMSourceImage -VM $VirtualMachine -PublisherName "Canonical" -Offer "UbuntuServer" -Skus "15.10" -Version "latest" -Caching ReadWrite
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption FromImage
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"
첫 번째 명령은 ResourceGroup11이라는 리소스 그룹에 AvailablitySet13이라는 가용성 집합을 가져오고 해당 개체를 $AvailabilitySet 변수에 저장합니다. 두 번째 명령은 가상 머신 개체를 만든 다음 $VirtualMachine 변수에 저장합니다. 이 명령은 가상 머신에 이름과 크기를 할당합니다. 가상 머신은 $AvailabilitySet 저장된 가용성 집합에 속합니다. 마지막 명령은 $VirtualMachine 가상 머신의 속성을 설정합니다.
예제 2: 일반화된 사용자 이미지에서 가상 머신의 속성 설정
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential)
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -SourceImageUri "https://mystorageaccount.blob.core.windows.net/vhds/myOSImage.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption fromImage -Linux
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"
첫 번째 명령은 ResourceGroup11이라는 리소스 그룹에서 AvailablitySet13이라는 가용성 집합을 가져오고 해당 개체를 $AvailabilitySet 변수에 저장합니다. 두 번째 명령은 가상 머신 개체를 만들고 $VirtualMachine 변수에 저장합니다. 이 명령은 가상 머신에 이름과 크기를 할당합니다. 가상 머신은 $AvailabilitySet 저장된 가용성 집합에 속합니다. 마지막 명령은 $VirtualMachine 가상 머신의 속성을 설정합니다.
예제 3: 특수 사용자 이미지에서 가상 머신의 속성 설정
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption Attach -Linux
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"
첫 번째 명령은 ResourceGroup11이라는 리소스 그룹에서 AvailablitySet13이라는 가용성 집합을 가져오고 해당 개체를 $AvailabilitySet 변수에 저장합니다. 두 번째 명령은 가상 머신 개체를 만들고 $VirtualMachine 변수에 저장합니다. 이 명령은 가상 머신에 이름과 크기를 할당합니다. 가상 머신은 $AvailabilitySet 저장된 가용성 집합에 속합니다. 마지막 명령은 $VirtualMachine 가상 머신의 속성을 설정합니다.
예제 4: 가상 머신 운영 체제 디스크에서 디스크 암호화 설정
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite -Windows -CreateOption "Attach" -DiskEncryptionKeyUrl "https://mytestvault.vault.azure.net/secrets/Test1/514ceb769c984379a7e0230bddaaaaaa" -DiskEncryptionKeyVaultId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mytestvault"
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName " ResourceGroup11"
다음은 가상 머신 운영 체제 디스크의 디스크 암호화 설정을 설정하는 예제입니다.
매개 변수
-Caching
운영 체제 디스크의 캐싱 모드를 지정합니다. 유효한 값은 다음과 같습니다.
- ReadOnly
- ReadWrite 기본값은 ReadWrite입니다. 캐싱 값을 변경하면 가상 머신이 다시 시작됩니다. 이 설정은 디스크의 성능에 영향을 줍니다.
형식: | Nullable<T>[CachingTypes] |
허용되는 값: | None, ReadOnly, ReadWrite |
Position: | 3 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-CreateOption
이 cmdlet은 플랫폼 또는 사용자 이미지에서 가상 머신에 디스크를 만들거나 기존 디스크를 연결할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- 붙이다. 특수 디스크에서 가상 머신을 만들려면 이 옵션을 지정합니다. 이 옵션을 지정할 때 SourceImageUri 매개 변수를 지정하지 마세요. 대신 Set-AzureRmVMSourceImage cmdlet을 사용합니다. 또한 Windows 또는 Linux 매개 변수를 사용하여 Azure 플랫폼에 VHD의 운영 체제 유형을 알려야 합니다. VhdUri 매개 변수는 Azure 플랫폼에 연결할 디스크의 위치를 알리기에 충분합니다.
- FromImage. 플랫폼 이미지 또는 일반화된 사용자 이미지에서 가상 머신을 만들려면 이 옵션을 지정합니다. 일반화된 사용자 이미지의 경우 Set-AzureRmVMSourceImage cmdlet을 사용하는 대신 Azure 플랫폼에 운영 체제 디스크 VHD의 위치 및 유형을 알리기 위해 SourceImageUri 매개 변수와 Windows 또는 Linux 매개 변수를 지정해야 합니다. 플랫폼 이미지 의 경우 VhdUri 매개 변수로 충분합니다.
- 비어 있음.
형식: | String |
Position: | 5 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
형식: | IAzureContextContainer |
별칭: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DiffDiskSetting
운영 체제 디스크에 대한 차이점 디스크 설정을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-DiskEncryptionKeyUrl
디스크 암호화 키의 위치를 지정합니다.
형식: | String |
Position: | 7 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DiskEncryptionKeyVaultId
디스크 암호화 키를 포함하는 Key Vault의 리소스 ID를 지정합니다.
형식: | String |
Position: | 8 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DiskSizeInGB
운영 체제 디스크의 크기(GB)를 지정합니다.
형식: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-KeyEncryptionKeyUrl
키 암호화 키의 위치를 지정합니다.
형식: | String |
Position: | 9 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-KeyEncryptionKeyVaultId
키 암호화 키를 포함하는 Key Vault의 리소스 ID를 지정합니다.
형식: | String |
Position: | 10 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Linux
사용자 이미지의 운영 체제가 Linux임을 나타냅니다. 사용자 이미지 기반 가상 머신 배포에 대해 이 매개 변수를 지정합니다.
형식: | SwitchParameter |
Position: | 6 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ManagedDiskId
관리 디스크의 ID를 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Name
운영 체제 디스크의 이름을 지정합니다.
형식: | String |
별칭: | OSDiskName, DiskName |
Position: | 1 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SourceImageUri
사용자 이미지 시나리오에 대한 VHD의 URI를 지정합니다.
형식: | String |
별칭: | SourceImage |
Position: | 4 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-StorageAccountType
관리 디스크의 스토리지 계정 유형을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VhdUri
VHD(가상 하드 디스크)의 URI(Uniform Resource Identifier)를 지정합니다. 이미지 기반 가상 머신의 경우 이 매개 변수는 플랫폼 이미지 또는 사용자 이미지를 지정할 때 만들 VHD 파일을 지정합니다. 가상 머신을 시작하기 위해 이미지 BLOB(Binary Large Object)이 복사되는 위치입니다. 디스크 기반 가상 머신 부팅 시나리오의 경우 이 매개 변수는 가상 머신이 시작에 직접 사용하는 VHD 파일을 지정합니다.
형식: | String |
별칭: | OSDiskVhdUri, DiskVhdUri |
Position: | 2 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VM
운영 체제 디스크 속성을 설정할 로컬 가상 머신 개체를 지정합니다. 가상 머신 개체를 가져오려면 Get-AzureRmVM cmdlet을 사용합니다.
형식: | PSVirtualMachine |
별칭: | VMProfile |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Windows
사용자 이미지의 운영 체제가 Windows임을 나타냅니다.
형식: | SwitchParameter |
Position: | 6 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WriteAccelerator
OS 디스크에서 WriteAccelerator를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
매개 변수: VM(ByValue)