New-AzStackHCIVMImage

Ссылка

Модуль:: Az.StackHCIVM

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

Синтаксис

New-AzStackHCIVMImage
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OSType <Object>
   -URN <String>
   [-CloudInitDataSource <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-StoragePathId <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzStackHCIVMImage
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OSType <Object>
   [-CloudInitDataSource <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-StoragePathId <String>]
   [-Tag <Hashtable>]
   -ImagePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzStackHCIVMImage
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OSType <Object>
   [-CloudInitDataSource <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-StoragePathId <String>]
   [-Tag <Hashtable>]
   -Offer <String>
   -Publisher <String>
   -Sku <String>
   -Version <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Примеры

Пример 1. Создание образа коллекции

New-AzStackHCIVMImage -Name "testImage" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}" -ImagePath "C:\ClusterStorage\Volume1\Ubunut.vhdx" -OSType "Linux" -Location "eastus"

Name            ResourceGroupName
----            -----------------
testImage       test-rg

Эта команда создает образ коллекции из локального пути.

Пример 2. Создание образа коллекции Marketplace

New-AzStackHCIVMImage -Name "testMarketplaceImage" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}"  -Location "eastus" -Offer "windowsserver" -Publisher "MicrosoftWindowsServer" -Sku "2022-Datacenter" -Version "latest" -OSType "Windows"

Name            ResourceGroupName
----            -----------------
testMarketplaceImage       test-rg

Эта команда создает образ коллекции Marketplace с помощью указанного предложения, издателя, SKU и версии.

Пример 3. {Создание образа коллекции Marketplace из URN

New-AzStackHCIVMImage -Name "testMarketplaceImageURN" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}"  -Location "eastus" -URN  "microsoftwindowsserver:windowsserver:2022-datacenter:latest" -OSType "Windows"

Name            ResourceGroupName
----            -----------------
testMarketplaceImageURN       test-rg

Эта команда создает образ коллекции Marketplace с помощью указанного urn.

Параметры

-AsJob

Выполнение команды в качестве задания

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

-CloudInitDataSource

Источник данных для образа коллекции при подготовке с помощью cloud-init [NoCloud, Azure]

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

-Confirm

Запрашивает подтверждение перед запуском командлета.

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

-CustomLocationId

Идентификатор ARM расширенного расположения для создания ресурса образа.

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

-DefaultProfile

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

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

-ImagePath

Локальный путь к изображению, из которому должен быть создан образ.

Этот параметр необходим для образов, отличных от Marketplace.

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

-Location

Географическое расположение, в котором находится ресурс

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

-Name

Имя изображения должно начинаться и заканчиваться буквенно-цифровым символом и содержать все буквенно-цифровые символы или "-", "." или "_". Максимальная длина может составлять 80 символов, а минимальная длина — 1 символ.

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

-NoWait

Асинхронное выполнение команды

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

-Offer

Имя предложения определения образа коллекции marketplae.

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

-OSType

Тип операционной системы, который использует образ коллекции [Windows, Linux]

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

-Publisher

Имя издателя определения образа коллекции Marketplace.

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

-ResourceGroupName

Имя группы ресурсов. Имя не учитывает регистр.

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

-Sku

Имя SKU определения образа коллекции Marketplace.

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

-StoragePathId

Контейнер хранилища контейнера хранилища, используемый для образа коллекции

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

-StoragePathName

Имя контейнера хранилища контейнера хранилища, используемого для образа коллекции

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

-StoragePathResourceGroup

Группа ресурсов пути к хранилищу. Значение по умолчанию — это группа ресурсов образа.

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

-SubscriptionId

Идентификатор целевой подписки.

Тип:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Tag

Теги ресурсов.

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

-URN

URN образа коллекции Marketplace.

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

-Version

Версия образа коллекции Marketplace.

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

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

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

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

IGalleryImages

IMarketplaceGalleryImages

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