New-AzureQuickVM

Ссылка

Модуль:: Azure

Настраивает и создает виртуальную машину Azure.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

New-AzureQuickVM
   [-Windows]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-AdminUsername <String>]
   [-Certificates <CertificateSettingList>]
   [-WaitForBoot]
   [-DisableWinRMHttps]
   [-EnableWinRMHttp]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

New-AzureQuickVM
   [-Linux]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-LinuxUser <String>]
   [-WaitForBoot]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Описание

Командлет New-AzureQuickVM настраивает и создает виртуальную машину Azure. Этот командлет может развернуть виртуальную машину в существующей службе Azure. Этот командлет может также создать службу Azure, на которой размещена новая виртуальная машина.

Примеры

Пример 1. Создание виртуальной машины

PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot

Эта команда создает виртуальную машину, которая запускает операционную систему Windows в существующей службе. Командлет основывает виртуальную машину на указанном образе. Команда задает параметр WaitForBoot . Поэтому командлет ожидает запуска виртуальной машины.

Пример 2. Создание виртуальной машины с помощью сертификатов

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
PS C:\> New-AzureQuickVM -Windows -ServiceName "MySvc1" -name "MyWinVM1" -ImageName "Image07" -Password "password" -AdminUserName "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] -WaitForBoot

Первая команда получает сертификаты из хранилища и сохраняет их в переменной $certs.

Вторая команда создает виртуальную машину, которая запускает операционную систему Windows в существующей службе из образа. По умолчанию прослушиватель Https WinRM включен на виртуальной машине. Команда задает параметр WaitForBoot . Поэтому командлет ожидает запуска виртуальной машины. Команда отправляет сертификат WinRM и X509Certificates в размещенную службу.

Пример 3. Создание виртуальной машины под управлением операционной системы Linux

PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"

Эта команда создает виртуальную машину, которая запускает операционную систему Linux из образа. Эта команда создает службу для размещения новой виртуальной машины. Команда указывает расположение службы.

Пример 4. Создание виртуальной машины и создание службы для размещения новой виртуальной машины

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService03" -Name " VirtualMachine25" -ImageName $images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name

Первая команда получает расположения с помощью командлета Get-AzureLocation, а затем сохраняет их в переменной массива $Locations.

Вторая команда получает доступные образы с помощью командлета Get-AzureVMImage , а затем сохраняет их в переменной массива $Images.

Последняя команда создает большую виртуальную машину с именем VirtualMachine25. Виртуальная машина запускает операционную систему Windows. Он основан на одном из изображений в $Images. Команда создает службу с именем ContosoService03 для новой виртуальной машины. Служба находится в расположении $Locations.

Пример 5. Создание виртуальной машины с зарезервированным IP-именем

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService04" -Name "VirtualMachine27" -ImageName $Images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name -ReservedIPName $ipName

Первая команда получает расположения, а затем сохраняет их в переменной массива $Locations.

Вторая команда получает доступные образы, а затем сохраняет их в переменной массива $Images.

Последняя команда создает виртуальную машину с именем VirtualMachine27 на основе одного из образов в $Images. Команда создает службу в расположении в $Locations. Виртуальная машина имеет зарезервированное IP-имя, ранее хранящееся в переменной $ipName.

Параметры

-AdminUsername

Указывает имя пользователя учетной записи администратора, которую этот командлет создает на виртуальной машине.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AffinityGroup

Указывает группу сходства для виртуальной машины. Укажите этот параметр или параметр location , только если этот командлет создает службу Azure для виртуальной машины.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AvailabilitySetName

Указывает имя группы доступности, в которой этот командлет создает виртуальную машину.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Certificates

Указывает список сертификатов, используемых этим командлетом для создания службы.

Тип:	CertificateSettingList
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CustomDataFile

Указывает файл данных для виртуальной машины. Этот командлет кодирует содержимое файла как Base64. Файл должен иметь длину менее 64 килобайтов.

Если гостевая операционная система является операционной системой Windows, этот командлет сохраняет эти данные в виде двоичного файла, который называется %SYSTEMDRIVE%\AzureData\CustomData.bin.

Если гостевая операционная система — Linux, этот командлет передает данные с помощью файла ovf-env.xml. Установка копирует этот файл в каталог /var/lib/waagent. Агент также сохраняет данные в кодировке Base64 в файле /var/lib/waagent/CustomData.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableGuestAgent

Указывает, что этот командлет отключает инфраструктуру как службу (IaaS) гостевой агент.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWinRMHttps

Указывает, что этот командлет отключает удаленное управление Windows (WinRM) на HTTPS. По умолчанию WinRM включен по протоколу HTTPS.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DnsSettings

Задает массив объектов DNS-сервера, определяющих параметры DNS для нового развертывания. Чтобы создать объект DnsServer , используйте командлет New-AzureDns .

Тип:	DnsServer[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableWinRMHttp

Указывает, что этот командлет включает WinRM по протоколу HTTP.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HostCaching

Задает режим кэширования узла для диска операционной системы. Допустимые значения:

ReadOnly
Чтение и запись

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ImageName

Указывает имя образа диска, который используется для создания диска операционной системы.

Тип:	String
Position:	Named
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

-InstanceSize

Указывает размер экземпляра. Допустимые значения:

ExtraSmall
Небольшой
Средняя
Большой
Очень большой
A5
A6
A7
A8
A9
Basic_A0
Basic_A1
Basic_A2
Basic_A3
Basic_A4
Standard_D1
Standard_D2
Standard_D3
Standard_D4
Standard_D11
Standard_D12
Standard_D13
Standard_D14

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Linux

Указывает, что этот командлет создает виртуальную машину на основе Linux.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-LinuxUser

Указывает имя пользователя учетной записи администратора Linux, которую этот командлет создает на виртуальной машине.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Location

Указывает центр обработки данных Azure, на котором размещена виртуальная машина. При указании этого параметра командлет создает службу Azure в указанном расположении. Укажите этот параметр или параметр AffinityGroup , только если этот командлет создает службу Azure для виртуальной машины.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MediaLocation

Указывает служба хранилища Azure расположение, в котором этот командлет создает диски виртуальных машин.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Указывает имя виртуальной машины, которую создает этот командлет.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NoExportPrivateKey

Указывает, что эта конфигурация не отправляет закрытый ключ.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NoWinRMEndpoint

Указывает, что этот командлет не добавляет конечную точку WinRM для виртуальной машины.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Password

Указывает пароль для учетной записи администратора.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Тип:	AzureSMProfile
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ReservedIPName

Указывает зарезервированное IP-имя.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ReverseDnsFqdn

Указывает полное доменное имя для обратного поиска DNS.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ServiceName

Указывает имя новой или существующей службы Azure, в которую этот командлет добавляет новую виртуальную машину.

При указании новой службы этот командлет создает его. Чтобы создать новую службу, необходимо указать параметр Location или AffinityGroup .

Если указать существующую службу, не указывайте расположение или affinityGroup.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SSHKeyPairs

Задает пары ключей SSH.

Тип:	SSHKeyPairList
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SSHPublicKeys

Указывает открытые ключи SSH.

Тип:	SSHPublicKeyList
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SubnetNames

Задает массив имен подсети для виртуальной машины.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VNetName

Указывает имя виртуальной сети для виртуальной машины.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WaitForBoot

Указывает, что этот командлет ожидает, пока виртуальная машина достигнет состояния ReadyRole. Если виртуальная машина достигает одного из следующих состояний, командлет завершается ошибкой: FailedStartingVM, ProvisioningFailed или ProvisioningTimeout.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Windows

Указывает, что этот командлет создает виртуальную машину Windows.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WinRMCertificate

Указывает сертификат, который этот командлет связывает с конечной точкой WinRM.

Тип:	X509Certificate2
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-X509Certificates

Задает массив сертификатов X509, развернутых в размещенной службе.

Тип:	X509Certificate2[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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