Set-AzureRmVMOperatingSystem
Определяет свойства операционной системы для виртуальной машины.
Предупреждение
Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.
Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.
Синтаксис
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Linux]
[-ComputerName] <String>
[-Credential] <PSCredential>
[[-CustomData] <String>]
[-DisablePasswordAuthentication]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет Set-AzureRmVMOperatingSystem задает свойства операционной системы для виртуальной машины. Вы можете указать учетные данные входа, имя компьютера и тип операционной системы.
Примеры
Пример 1. Задание свойств операционной системы для новых виртуальных машин
PS C:\> $SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
PS C:\> $Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
PS C:\> $ComputerName = "ContosoVM122"
PS C:\> $WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
PS C:\> $TimeZone = "Pacific Standard Time"
PS C:\> $CustomData = "echo 'Hello World'"
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $$VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone
Первая команда преобразует пароль в безопасную строку, а затем сохраняет ее в переменной $SecurePassword.
Для получения дополнительных сведений введите Get-Help ConvertTo-SecureString
.
Вторая команда создает учетные данные для пользователя FullerP и пароля, хранящегося в $SecurePassword, а затем сохраняет учетные данные в переменной $Credential.
Для получения дополнительных сведений введите Get-Help New-Object
.
Третья команда получает группу доступности с именем AvailabilitablitySet03 в группе ресурсов с именем ResourceGroup11, а затем сохраняет этот объект в переменной $AvailabilitySet.
Четвертая команда создает объект виртуальной машины, а затем сохраняет его в переменной $VirtualMachine.
Команда присваивает имя и размер виртуальной машине.
Виртуальная машина принадлежит группе доступности, хранящейся в $AvailabilitySet.
Следующие четыре команды назначают значения переменным для использования в следующей команде.
Так как эти строки можно указать непосредственно в команде Set-AzureRmVMOperatingSystem , этот подход используется только для удобства чтения.
Однако вы можете использовать такой подход, как это в сценариях.
Последняя команда задает свойства операционной системы для виртуальной машины, хранящейся в $VirtualMachine.
Команда использует учетные данные, хранящиеся в $Credential.
Команда использует переменные, назначенные в предыдущих командах для некоторых параметров.
Параметры
-ComputerName
Указывает имя компьютера.
Тип: | String |
Position: | 2 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Credential
Указывает имя пользователя и пароль виртуальной машины в качестве объекта PSCredential .
Чтобы получить учетные данные, используйте командлет Get-Credential.
Для получения дополнительных сведений введите Get-Help Get-Credential
.
Тип: | PSCredential |
Position: | 3 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-CustomData
Задает строку в кодировке base-64 пользовательских данных. Это декодируется в двоичный массив, сохраненный в виде файла на виртуальной машине. Максимальная длина двоичного массива составляет 65535 байтов.
Тип: | String |
Position: | 4 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisablePasswordAuthentication
Указывает, что этот командлет отключает проверку подлинности паролей.
Тип: | SwitchParameter |
Position: | 5 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-DisableVMAgent
Отключите агент виртуальной машины подготовки.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EnableAutoUpdate
Указывает, что этот командлет включает автоматическое обновление.
Тип: | SwitchParameter |
Position: | 6 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Linux
Указывает, что тип операционной системы — Linux.
Тип: | SwitchParameter |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ProvisionVMAgent
Указывает, что параметры требуют установки агента виртуальной машины на виртуальной машине.
Тип: | SwitchParameter |
Position: | 5 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-TimeZone
Указывает часовой пояс виртуальной машины.
Тип: | String |
Position: | 7 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-VM
Указывает объект локальной виртуальной машины, для которого необходимо задать свойства операционной системы. Чтобы получить объект виртуальной машины, используйте командлет Get-AzureRmVM. Создайте объект виртуальной машины с помощью командлета New-AzureRmVMConfig.
Тип: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Windows
Указывает, что тип операционной системы — Windows.
Тип: | SwitchParameter |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WinRMCertificateUrl
Задает универсальный код ресурса (URI) сертификата WinRM. Это необходимо хранить в Key Vault.
Тип: | Uri |
Position: | 10 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WinRMHttp
Указывает, что эта операционная система использует HTTP WinRM.
Тип: | SwitchParameter |
Position: | 8 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WinRMHttps
Указывает, что эта операционная система использует HTTPS WinRM.
Тип: | SwitchParameter |
Position: | 9 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |