New-AzImageConfig
Cria um objeto de imagem configurável.
Sintaxe
Default (Padrão)
New-AzImageConfig
[[-Location] <String>]
[-EdgeZone <String>]
[[-Tag] <Hashtable>]
[[-SourceVirtualMachineId] <String>]
[[-OsDisk] <ImageOSDisk>]
[-HyperVGeneration <String>]
[-DataDisk <ImageDataDisk[]>]
[-ZoneResilient]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
O cmdlet New-AzImageConfig cria um objeto de imagem configurável.
Exemplos
Exemplo 1
$imageConfig = New-AzImageConfig -Location 'West US';
$osDiskVhdUri = "https://contoso.blob.core.windows.net/test/os.vhd"
$dataDiskVhdUri1 = "https://contoso.blob.core.windows.net/test/data1.vhd"
$dataDiskVhdUri2 = "https://contoso.blob.core.windows.net/test/data2.vhd"
Set-AzImageOsDisk -Image $imageConfig -OsType 'Windows' -OsState 'Generalized' -BlobUri $osDiskVhdUri;
Add-AzImageDataDisk -Image $imageConfig -Lun 1 -BlobUri $dataDiskVhdUri1;
Add-AzImageDataDisk -Image $imageConfig -Lun 2 -BlobUri $dataDiskVhdUri2;
New-AzImage -Image $imageConfig -ImageName 'ImageName01' -ResourceGroupName 'ResourceGroup01';
O primeiro comando cria um objeto de imagem e, em seguida, armazena-o na variável $imageConfig.
Os próximos três comandos atribuem caminhos de disco do sistema operacional e dois discos de dados às variáveis $osDiskVhdUri, $dataDiskVhdUri 1 e $dataDiskVhdUri 2. Esta abordagem é apenas para legibilidade dos seguintes comandos.
Cada um dos próximos três comandos adiciona um disco OS e dois discos de dados à imagem armazenada no $imageConfig.
O URI de cada disco é armazenado em $osDiskVhdUri, $dataDiskVhdUri 1 e $dataDiskVhdUri 2.
O comando final cria uma imagem chamada 'ImageName01' no grupo de recursos 'ResourceGroup01'.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: Cf.
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-DataDisk
Especifica o objeto de disco de dados.
Propriedades dos parâmetros
Tipo: ImageDataDisk [ ]
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-EdgeZone
Define o nome da zona de borda. Se definida, a consulta será roteada para a zona de borda especificada em vez da região principal.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-HyperVGeneration
Especifica o tipo HyperVGeneration para a máquina virtual criada a partir da imagem. Os valores permitidos são V1 e V2.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-Location
Especifica um local.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: 0
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-OsDisk
Especifica o disco do sistema operacional.
Propriedades dos parâmetros
Tipo: ImageOSDisk
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: 3
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-SourceVirtualMachineId
Especifica o ID da máquina virtual de origem.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: 2
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-Tag
Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}
Propriedades dos parâmetros
Tipo: Hashtable
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: 1
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: Wi
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-ZoneResilient
Ativar zona resiliente
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas