Set-AzVMOperatingSystem
Задает свойства операционной системы во время создания новой виртуальной машины или обновления виртуальной машины.
Синтаксис
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Linux]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-PatchMode <String>]
[-DisablePasswordAuthentication]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет Set-AzVMOperatingSystem задает свойства операционной системы во время создания новой виртуальной машины. Вы можете указать учетные данные входа, имя компьютера и тип операционной системы.
Примеры
Пример 1. Задание свойств операционной системы для новой виртуальной машины
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
$TimeZone = "Pacific Standard Time"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone -PatchMode "AutomaticByPlatform"
Первая команда преобразует пароль в безопасную строку, а затем сохраняет ее в переменной $SecurePassword.
Для получения дополнительных сведений введите Get-Help ConvertTo-SecureString
.
Вторая команда создает учетные данные для пользователя FullerP и пароля, хранящегося в $SecurePassword, а затем сохраняет учетные данные в переменной $Credential.
Для получения дополнительных сведений введите Get-Help New-Object
.
Третья команда получает группу доступности с именем AvailabilitySet03 в группе ресурсов с именем ResourceGroup11, а затем сохраняет этот объект в переменной $AvailabilitySet.
Четвертая команда создает объект виртуальной машины, а затем сохраняет его в переменной $VirtualMachine.
Команда присваивает имя и размер виртуальной машине.
Виртуальная машина принадлежит группе доступности, хранящейся в $AvailabilitySet.
Следующие четыре команды назначают значения переменным для использования в следующей команде.
Так как эти строки можно указать непосредственно в команде Set-AzVMOperatingSystem , этот подход используется только для удобства чтения.
Однако вы можете использовать такой подход, как это в сценариях.
Последняя команда задает свойства операционной системы для виртуальной машины, хранящейся в $VirtualMachine.
Команда использует учетные данные, хранящиеся в $Credential.
Команда использует переменные, назначенные в предыдущих командах для некоторых параметров.
Пример 2. Задание свойств операционной системы для новой виртуальной машины с включенной горячей исправлением
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
$TimeZone = "Pacific Standard Time"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone -PatchMode "AutomaticByPlatform" -EnableHotPatching
Первая команда преобразует пароль в безопасную строку, а затем сохраняет ее в переменной $SecurePassword.
Для получения дополнительных сведений введите Get-Help ConvertTo-SecureString
.
Вторая команда создает учетные данные для пользователя FullerP и пароля, хранящегося в $SecurePassword, а затем сохраняет учетные данные в переменной $Credential.
Для получения дополнительных сведений введите Get-Help New-Object
.
Третья команда получает группу доступности с именем AvailabilitySet03 в группе ресурсов с именем ResourceGroup11, а затем сохраняет этот объект в переменной $AvailabilitySet.
Четвертая команда создает объект виртуальной машины, а затем сохраняет его в переменной $VirtualMachine.
Команда присваивает имя и размер виртуальной машине.
Виртуальная машина принадлежит группе доступности, хранящейся в $AvailabilitySet.
Следующие четыре команды назначают значения переменным для использования в следующей команде.
Так как эти строки можно указать непосредственно в команде Set-AzVMOperatingSystem , этот подход используется только для удобства чтения.
Однако вы можете использовать такой подход, как это в сценариях.
Последняя команда задает свойства операционной системы для виртуальной машины, хранящейся в $VirtualMachine.
Команда использует учетные данные, хранящиеся в $Credential.
Команда использует переменные, назначенные в предыдущих командах для некоторых параметров.
Эта команда включает hotpatching на виртуальной машине.
Пример 3. Задание свойств операционной системы для новой виртуальной машины Linux
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -PatchMode "AutomaticByPlatform"
Первая команда преобразует пароль в безопасную строку, а затем сохраняет ее в переменной $SecurePassword.
Для получения дополнительных сведений введите Get-Help ConvertTo-SecureString
.
Вторая команда создает учетные данные для пользователя FullerP и пароля, хранящегося в $SecurePassword, а затем сохраняет учетные данные в переменной $Credential.
Для получения дополнительных сведений введите Get-Help New-Object
.
Третья команда получает группу доступности с именем AvailabilitySet03 в группе ресурсов с именем ResourceGroup11, а затем сохраняет этот объект в переменной $AvailabilitySet.
Четвертая команда создает объект виртуальной машины, а затем сохраняет его в переменной $VirtualMachine.
Команда присваивает имя и размер виртуальной машине.
Виртуальная машина принадлежит группе доступности, хранящейся в $AvailabilitySet.
Следующие две команды назначают значения переменным для использования в следующей команде.
Последняя команда задает свойства операционной системы для виртуальной машины, хранящейся в $VirtualMachine.
Команда использует учетные данные, хранящиеся в $Credential.
Команда использует переменные, назначенные в предыдущих командах для некоторых параметров.
Команда задает значение режима исправления на виртуальной машине значение AutomaticByPlatform.
Параметры
-AssessmentMode
Значение режима автоматической оценки для виртуальной машины. Возможные значения: ImageDefault и AutomaticByPlatform.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Указывает имя компьютера.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
Указывает имя пользователя и пароль виртуальной машины в качестве объекта PSCredential .
Чтобы получить учетные данные, используйте командлет Get-Credential.
Для получения дополнительных сведений введите Get-Help Get-Credential
.
Type: | PSCredential |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CustomData
Указывает строку, передаваемую виртуальной машине. Дополнительные сведения см. в разделе "Пользовательские данные" на виртуальных машинах Azure. Примечание. Не рекомендуется хранить конфиденциальную информацию в пользовательских данных.
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisablePasswordAuthentication
Указывает, что этот командлет отключает проверку подлинности паролей.
Type: | SwitchParameter |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisableVMAgent
Отключите агент виртуальной машины подготовки.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAutoUpdate
Указывает, что этот командлет включает автоматическое обновление.
Type: | SwitchParameter |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableHotpatching
Позволяет клиентам исправлять виртуальные машины Azure без перезагрузки. Для включенияHotpatching для параметра provisionVMAgent должно быть задано значение true, а для patchMode должно быть задано значение AutomaticByPlatform.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Linux
Указывает, что тип операционной системы — Linux.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PatchMode
Задает режим гостевой исправления для виртуальной машины IaaS.
Возможны следующие значения:
AutomaticByPlatform — установка исправлений для виртуальной машины будет управляться Azure. Используйте с -Windows или -Linux. Требуется -ProvisionVMAgent. Требуется -EnableAutoUpdate при использовании с -Windows.
AutomaticByOS — установка исправлений для виртуальной машины будет управляться ОС. Используйте с -Windows. Требуется -ProvisionVMAgent и -EnableAutoUpdate.
Вручную . Вы управляете применением исправлений к виртуальной машине. Используйте с -Windows. Требуется -ProvisionVMAgent.
ImageDefault — установка исправлений, управляемая параметрами по умолчанию на образе ОС. Используйте с -Linux.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProvisionVMAgent
Указывает, что параметры требуют установки агента виртуальной машины на виртуальной машине.
Type: | SwitchParameter |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeZone
Указывает часовой пояс виртуальной машины. Например, "Тихоокеанское стандартное время".
Возможные значения можно TimeZoneInfo.Id из часовых поясов, возвращаемых TimeZoneInfo.GetSystemTimeZones.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
Указывает объект локальной виртуальной машины, для которого необходимо задать свойства операционной системы. Чтобы получить объект виртуальной машины, используйте командлет Get-AzVM. Создайте объект виртуальной машины с помощью командлета New-AzVMConfig.
Type: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Windows
Указывает, что тип операционной системы — Windows.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMCertificateUrl
Задает универсальный код ресурса (URI) сертификата WinRM. Это необходимо хранить в Key Vault.
Type: | Uri |
Position: | 10 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMHttp
Указывает, что эта операционная система использует HTTP WinRM.
Type: | SwitchParameter |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WinRMHttps
Указывает, что эта операционная система использует HTTPS WinRM.
Type: | SwitchParameter |
Position: | 9 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |