Set-AzureDataDisk
Изменяет кэширование узла существующего диска данных на виртуальной машине Azure.
Примечание.
Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.
Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.
Синтаксис
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>]
Описание
Командлет Set-AzureDataDisk изменяет атрибуты кэша существующего диска данных на виртуальной машине Azure. Укажите, какой диск данных нужно обновить по логическому номеру единицы (LUN).
Примеры
Пример 1. Изменение кэширования узла для диска данных
PS C:\> Get-AzureVM "ContosoService" | Set-AzureDataDisk -VM "VirtualMachine07" -LUN 2 -HostCaching ReadOnly | Update-AzureVM
Эта команда получает виртуальные машины, которые выполняются в службе с именем ContosoService с помощью командлета Get-AzureVM . Команда передает их текущему командлету с помощью оператора конвейера. Этот командлет задает диск данных в LUN 2 виртуальной машины с именем VirtualMachine07 для использования кэширования узла ReadOnly. Команда обновляет виртуальную машину, чтобы отразить изменения с помощью командлета Update-AzureVM .
Пример 2. Изменение кэширования узла для всех дисков данных на виртуальной машине
PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Get-AzureDataDisk | Set-AzureDataDisk -HostCaching ReadWrite | Update-AzureVM
Эта команда получает объект для виртуальной машины с именем VirtualMachine07 в облачной службе ContosoService. Команда передает ее командлету Get-AzureDataDisk , который получает диски данных для этой виртуальной машины. Затем текущий командлет задает режим кэширования узла для каждого диска данных для ReadWrite. Команда обновляет виртуальную машину, чтобы отразить изменения.
Параметры
-DiskName
Указывает имя конфигурации диска данных, которая изменяет этот командлет.
Тип: | String |
Position: | 3 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-HostCaching
Предупреждение
Кэширование диска не поддерживается для дисков размером 4 ТиБ и более. Если к виртуальной машине подключено несколько дисков, то кэширование применяется ко всем дискам, размер которых меньше 4 ТиБ.
При изменении режима кэширования для диска Azure этот диск отключается и заново подключается к виртуальной машине. Если это диск операционной системы, то виртуальная машина перезагрузится. Остановите все приложения и службы, работу которых может нарушить это событие, прежде чем изменять параметр кэша диска. Несоблюдение этих рекомендаций может привести к повреждению данных.
Указывает параметры кэширования на уровне узла диска. Допустимые значения:
- нет
- ReadOnly
- Чтение и запись
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InformationAction
Указывает, как этот командлет реагирует на событие сведений.
Допустимые значения для этого параметра:
- Продолжить
- Пропустить
- Спрашивать
- SilentlyContinue
- Остановить
- Приостановить
Тип: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InformationVariable
Указывает переменную сведений.
Тип: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-LUN
Указывает LUN для диска данных на виртуальной машине. Допустимые значения: от 0 до 15.
Тип: | Int32 |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Profile
Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.
Тип: | AzureSMProfile |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResizedSizeInGB
Задает новый размер в гигабайтах для диска данных. Новый размер должен быть больше текущего размера.
Тип: | Int32 |
Position: | 4 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VM
Указывает объект виртуальной машины, подключенный к диску данных. Чтобы получить объект виртуальной машины, используйте командлет Get-AzureVM .
Тип: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |