Set-AzureRmVMOSDisk
Задает свойства диска операционной системы для виртуальной машины.
Предупреждение
Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из 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>] Описание
Командлет Set-AzureRmVMOSDisk задает свойства диска операционной системы на виртуальной машине.
Примеры
Пример 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"Первая команда получает группу доступности с именем AvailabilitablitySet13 в группе ресурсов с именем ResourceGroup11, а затем сохраняет этот объект в переменной $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"Первая команда получает группу доступности с именем AvailabilitablitySet13 в группе ресурсов с именем ResourceGroup11 и сохраняет этот объект в переменной $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"Первая команда получает группу доступности с именем AvailabilitablitySet13 в группе ресурсов с именем ResourceGroup11 и сохраняет этот объект в переменной $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
Указывает, создает ли этот командлет диск на виртуальной машине на основе платформы или пользовательского образа или подключает существующий диск. Допустимые значения:
- Прикреплять. Укажите этот параметр для создания виртуальной машины на специализированном диске. При указании этого параметра не указывайте параметр SourceImageUri . Вместо этого используйте командлет Set-AzureRmVMSourceImage. Кроме того, необходимо использовать параметры Windows или Linux , чтобы сообщить платформе Azure тип операционной системы на виртуальном жестком диске. Параметр VhdUri достаточно, чтобы сообщить платформе Azure расположение диска для подключения.
- FromImage. Укажите этот параметр, чтобы создать виртуальную машину на основе образа платформы или обобщенного пользовательского образа. В случае обобщенного образа пользователя также необходимо указать параметр SourceImageUri и параметры Windows или Linux, чтобы сообщить платформе Azure расположение и тип виртуального жесткого диска операционной системы вместо использования командлета Set-AzureRmVMSourceImage. В случае образа платформы параметр VhdUri достаточно.
- Пусто
| Тип: | String |
| Position: | 5 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
| Тип: | IAzureContextContainer |
| Aliases: | 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
Указывает идентификатор ресурса Хранилища ключей, содержащий ключ шифрования диска.
| Тип: | String |
| Position: | 8 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DiskSizeInGB
Указывает размер диска операционной системы в ГБ.
| Тип: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-KeyEncryptionKeyUrl
Указывает расположение ключа шифрования ключа.
| Тип: | String |
| Position: | 9 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-KeyEncryptionKeyVaultId
Указывает идентификатор ресурса Хранилища ключей, содержащий ключ шифрования ключей.
| Тип: | String |
| Position: | 10 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Linux
Указывает, что операционная система на пользовательском образе — Linux. Укажите этот параметр для развертывания виртуальных машин на основе пользовательского образа.
| Тип: | SwitchParameter |
| Position: | 6 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ManagedDiskId
Указывает идентификатор управляемого диска.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Указывает имя диска операционной системы.
| Тип: | String |
| Aliases: | OSDiskName, DiskName |
| Position: | 1 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SourceImageUri
Задает универсальный код ресурса (URI) виртуального жесткого диска для сценариев пользовательского образа.
| Тип: | String |
| Aliases: | SourceImage |
| Position: | 4 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-StorageAccountType
Указывает тип учетной записи хранения управляемого диска.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-VhdUri
Указывает универсальный идентификатор ресурса (URI) виртуального жесткого диска (VHD). Для виртуальной машины на основе образа этот параметр указывает VHD-файл для создания при указании образа платформы или пользовательского образа. Это расположение, из которого копируется двоичный большой объект образа (BLOB), чтобы запустить виртуальную машину. Для сценария загрузки виртуальной машины на основе диска этот параметр указывает VHD-файл, который виртуальная машина использует непосредственно для запуска.
| Тип: | String |
| Aliases: | OSDiskVhdUri, DiskVhdUri |
| Position: | 2 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-VM
Указывает объект локальной виртуальной машины, на котором необходимо задать свойства диска операционной системы. Чтобы получить объект виртуальной машины, используйте командлет Get-AzureRmVM.
| Тип: | PSVirtualMachine |
| Aliases: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Windows
Указывает, что операционная система на пользовательском образе — Windows.
| Тип: | SwitchParameter |
| Position: | 6 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WriteAccelerator
Указывает, следует ли включить или отключить WriteAccelerator на диске ОС.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Параметры: виртуальная машина (ByValue)