New-AzureRmImage

Referencia

Módulo:: AzureRM.Compute

Crea una imagen.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

New-AzureRmImage
   [-ResourceGroupName] <String>
   [-ImageName] <String>
   [-Image] <PSImage>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzureRmImage crea una imagen.

Ejemplos

Ejemplo 1

PS C:\> $imageConfig = New-AzureRmImageConfig -Location 'West US';
PS C:\> $osDiskVhdUri = "https://contoso.blob.core.windows.net/test/os.vhd"
PS C:\> $dataDiskVhdUri1 = "https://contoso.blob.core.windows.net/test/data1.vhd"
PS C:\> $dataDiskVhdUri2 = "https://contoso.blob.core.windows.net/test/data2.vhd"
PS C:\> Set-AzureRmImageOsDisk -Image $imageConfig -OsType 'Windows' -OsState 'Generalized' -BlobUri $osDiskVhdUri;
PS C:\> Add-AzureRmImageDataDisk -Image $imageConfig -Lun 1 -BlobUri $dataDiskVhdUri1;
PS C:\> Add-AzureRmImageDataDisk -Image $imageConfig -Lun 2 -BlobUri $dataDiskVhdUri2;
PS C:\> New-AzureRmImage -Image $imageConfig -ImageName 'ImageName01' -ResourceGroupName 'ResourceGroup01';

El primer comando crea un objeto de imagen y, a continuación, lo almacena en la variable $imageConfig. Los tres comandos siguientes asignan rutas de acceso del disco del sistema operativo y dos discos de datos a las variables $osDiskVhdUri, $dataDiskVhdUri 1 y $dataDiskVhdUri 2. Este enfoque solo es para la legibilidad de los siguientes comandos. Los tres comandos siguientes agregan un disco del sistema operativo y dos discos de datos a la imagen almacenada en $imageConfig. El URI de cada disco se almacena en $osDiskVhdUri, $dataDiskVhdUri 1 y $dataDiskVhdUri 2. El comando final crea una imagen denominada "ImageName01" en el grupo de recursos "ResourceGroup01".

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Image

Especifica un objeto de imagen local.

Tipo:	PSImage
Position:	3
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ImageName

Especifica el nombre de una imagen.

Tipo:	String
Aliases:	Name
Position:	2
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Especifica el nombre de un grupo de recursos.

Tipo:	String
Position:	1
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

PSImage

Parámetros: Imagen (ByValue)

Salidas