Partilhar via


New-AzGalleryImageDefinition

Crie uma definição de imagem de galeria.

Sintaxe

New-AzGalleryImageDefinition
   [-ResourceGroupName] <String>
   [-GalleryName] <String>
   [-Name] <String>
   [-AsJob]
   [-Location] <String>
   -Publisher <String>
   -Offer <String>
   -Sku <String>
   -OsState <OperatingSystemStateTypes>
   -OsType <OperatingSystemTypes>
   [-Description <String>]
   [-DisallowedDiskType <String[]>]
   [-EndOfLifeDate <DateTime>]
   [-Eula <String>]
   [-HyperVGeneration <String>]
   [-MinimumMemory <Int32>]
   [-MinimumVCPU <Int32>]
   [-MaximumMemory <Int32>]
   [-MaximumVCPU <Int32>]
   [-PrivacyStatementUri <String>]
   [-PurchasePlanName <String>]
   [-PurchasePlanProduct <String>]
   [-PurchasePlanPublisher <String>]
   [-ReleaseNoteUri <String>]
   [-Tag <Hashtable>]
   [-Feature <GalleryImageFeature[]>]
   [-Architecture <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Crie uma definição de imagem de galeria. A definição de imagem da galeria será definida como padrão como 'HyperVGeneration: V2' e 'SecurityType: TrustedLaunchSupported' se -HyperVGeneration e -Feature @{Name: SecurityType} não estiver definida explicitamente. Defina SecurityType como 'Nenhum' para desativar esse padrão (consulte o Exemplo 10).

Exemplos

Exemplo 1: Criar uma definição de imagem para imagens linux especializadas

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$description = "My gallery"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Specialized" -OsType "Linux" -Description $description

Cria uma definição de imagem de galeria para conter versões de imagem para imagens linux especializadas. Isso padronizará a Imagem da Galeria para HyperVGeneration V2 e Inicialização Confiável como -HyperVGeneration e -Feature SecurityType não está definida explicitamente.

Exemplo 2: Criar uma definição de imagem para imagens linux generalizadas

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$description = "My gallery"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -Description $description

Cria uma definição de imagem de galeria para conter versões de imagem para imagens linux generalizadas.

Exemplo 3: Criar uma definição de imagem para imagens especializadas do Windows

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$description = "My gallery"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Specialized" -OsType "Windows" -Description $description

Cria uma definição de imagem de galeria para conter versões de imagem para imagens especializadas do Windows.

Exemplo 4: Crie uma definição de imagem para imagens generalizadas do Windows e defina recursos.

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$description = "My gallery"
$IsHibernateSupported = @{Name='IsHibernateSupported';Value='True'}
$IsAcceleratedNetworkSupported = @{Name='IsAcceleratedNetworkSupported';Value='False'}
$ConfidentialVMSupported = @{Name='SecurityType';Value='ConfidentialVMSupported'}
$features = @($IsHibernateSupported,$IsAcceleratedNetworkSupported, $ConfidentialVMSupported)
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Windows" -Description $description -Feature $features -HyperVGeneration "V2"

Cria uma definição de imagem de galeria para conter versões de imagem para imagens generalizadas do Windows.

Exemplo 5: Criar uma definição de imagem com informações do plano

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$purchasePlanName = "myPlanName"
$purchasePlanProduct = "myPlanProduct"
$purchasePlanPublisher = "myPlanPublisher"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -PurchasePlanName $purchasePlanName -PurchasePlanProduct $purchasePlanProduct -PurchasePlanPublisher $purchasePlanPublisher

Cria uma definição de imagem de galeria para imagens generalizadas do linux e define o nome do plano, o produto e o editor. Apenas versões de imagem que correspondam às informações do plano podem ser adicionadas a esta definição.

Exemplo 6: Criar uma definição de imagem e indicar a data de fim de vida útil

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$endOfLifeDate = "2024-08-02T00:00:00+00:00"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -EndOfLifeDate $endOfLifeDate

Este exemplo tem a data de fim de vida para definições de imagem definida como 2 de agosto de 2024 no mignight UTC. As datas de fim de vida podem ser especificadas para definições de imagem e versões de imagem. As definições de imagem ainda podem ser usadas após as datas de fim de vida.

Exemplo 7: Criar uma definição de imagem e recomendar CPU e memória mínimas e máximas (GB)

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$minMemory = 32
$maxMemory = 128
$minVCPU = 2
$maxVCPU = 8
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -MinimumMemory $minMemory -MaximumMemory $maxMemory -MinimumVCPU $minVCPU -MaximumVCPU $maxVCPU

Cria uma definição de imagem de galeria e recomenda os intervalos mínimo e máximo para a CPU e a memória suportados pelas versões de imagem nesta definição de imagem. As versões de imagem ainda podem ser usadas para criar máquinas virtuais com configurações de memória e vCPU fora dos intervalos recomendados.

Exemplo 8: Criar uma definição de imagem e indicar quais tipos de disco do sistema operacional não são recomendados para a imagem

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$disallowedDiskTypes = @("Standard_LRS")
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -DisallowedDiskType $disallowedDiskTypes

Cria uma definição de imagem de galeria e indica quais tipos de disco do sistema operacional podem não ser compatíveis com versões de imagem dentro dessa definição de imagem. As versões de imagem ainda podem ser usadas para criar máquinas virtuais com um disco do sistema operacional que é um dos tipos de disco não permitidos.

Exemplo 9: Criar uma definição de imagem e fornecer o EULA, o URI da declaração de privacidade e o URI das notas de versão

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"
$eula = "https://myeula"
$privacyStatementUri = "https://mystatement"
$releaseNoteUri = "https://myreleasenotes"
New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -Eula $eula -PrivacyStatementUri $privacyStatementUri -ReleaseNoteUri $releaseNoteUri

Cria uma definição de imagem de galeria para imagens generalizadas do linux e especifica a cadeia de caracteres ou o caminho para um contrato EULA, declaração de privacidade e notas de versão vinculadas a todas as versões de imagem na definição de imagem.

Exemplo 10: Criar uma definição de imagem de galeria com o recurso SecurityType padrão

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$location = "eastus"
$publisherName = "GreatPublisher"
$offerName = "GreatOffer"
$skuName = "GreatSku"

$Feature1 = @{Name='SecurityType';Value='None'}
$Features = @($Feature1)

New-AzGalleryImageDefinition -ResourceGroupName $rgName -GalleryName $galleryName -Name $galleryImageDefinitionName -Location $location -Publisher $publisherName -Offer $offerName -Sku $skuName -OsState "Generalized" -OsType "Linux" -Feature $Features

Crie uma definição de imagem de galeria com o recurso de tipo de segurança padrão fornecendo 'Nenhum' como o valor do recurso SecurityType.

Parâmetros

-Architecture

Arquitetura de CPU suportada por um disco do sistema operacional. Os valores possíveis são "X64" e "Arm64".

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

A descrição do recurso Definição de imagem da galeria.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DisallowedDiskType

Os tipos de disco não permitidos.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EndOfLifeDate

A data de fim da vida útil da galeria Definição de imagem

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Eula

O acordo Eula para a definição de imagem da galeria.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Feature

Uma lista de recursos de imagem da galeria. Para SecurityType, as entradas aceitáveis são: None, TrustedlaunchSupported, Trustedlaunch, ConfidentialVM, ConfidentialVMSupported, TrustedandConfidentialVMSupported

Tipo:GalleryImageFeature[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-GalleryName

O nome da galeria.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-HyperVGeneration

A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO. Os valores permitidos são V1 e V2.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Location

Localização do recurso

Tipo:String
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MaximumMemory

O máximo da memória recomendada

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MaximumVCPU

O máximo do núcleo de CPU recomendado

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MinimumMemory

O mínimo da memória recomendada

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MinimumVCPU

O mínimo do núcleo de CPU recomendado

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

O nome da definição da imagem da galeria.

Tipo:String
Aliases:GalleryImageDefinitionName
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Offer

O nome da oferta Definição de imagem da galeria.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OsState

O estado do SO

Tipo:OperatingSystemStateTypes
Valores aceites:Generalized, Specialized
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OsType

O tipo de SO

Tipo:OperatingSystemTypes
Valores aceites:Windows, Linux
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PrivacyStatementUri

A declaração de privacidade uri.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Publisher

O nome do editor de definição de imagem da galeria.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PurchasePlanName

O ID do plano de compra.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PurchasePlanProduct

O ID do produto para o plano de compra.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PurchasePlanPublisher

O ID do editor para o plano de compra.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ReleaseNoteUri

A nota de lançamento uri.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Sku

O nome da galeria Image Definition SKU.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Tag

Etiquetas de recursos

Tipo:Hashtable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

OperatingSystemStateTypes

OperatingSystemTypes

DateTime

Hashtable

Int32

String[]

Saídas

PSGalleryImage