Поделиться через


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

Входные данные

PSVirtualMachine

SwitchParameter

String

PSCredential

Uri

Выходные данные

PSVirtualMachine