Add-AzureRmImageDataDisk

NAME Add-AzureRmImageDataDisk



SYNOPSIS

Adds a data disk to an image obejct.





SYNTAX

Add-AzureRmImageDataDisk [-Image] <PSImage> [[-Lun] <Int32>] [[-BlobUri] <String>] [[-Caching] {None | ReadOnly | ReadWrite}] [-DefaultProfile

<IAzureContextContainer>] [-DiskSizeGB <Int32>] [-ManagedDiskId <String>] [-SnapshotId <String>] [-StorageAccountType <String>] [-Confirm]

[-WhatIf] [<CommonParameters>]





DESCRIPTION

The Add-AzureRmImageDataDisk cmdlet adds a data disk to an image object.





PARAMETERS

-BlobUri <String>

Specifies the link, as a URI, of the blob.



Required? false

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Caching <CachingTypes>

Specifies the caching mode of the disk.



Required? false

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DiskSizeGB <Int32>

Specifies the size of the disk in Gigabytes (GB).



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Image <PSImage>

Specifies a local image object.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName, ByValue)

Accept wildcard characters? false



-Lun <Int32>

Specifies the logical unit number (LUN).



Required? false

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ManagedDiskId <String>

Specifies the ID of a managed disk.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-SnapshotId <String>

Specifies the ID of a snapshot.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-StorageAccountType <String>

The Storage Account type of the data image disk



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Microsoft.Azure.Management.Compute.Models.Image

System.Int32 System.String System.Nullable`1[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute,

Version=14.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]] System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0,

Culture=neutral, PublicKeyToken=b77a5c561934e089]]





OUTPUTS

Microsoft.Azure.Management.Compute.Models.Image







NOTES









Example 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';



The first command creates an image object, and then stores it in the $imageConfig variable.



The next three commands assign paths of operating system disk and two data disks to the $osDiskVhdUri, $dataDiskVhdUri1, and $dataDiskVhdUri2

variables. This approach is only for readability of the following commands.



The next three commands each adds an operating system disk and two data disks to the image stored in $imageConfig. The URI of each disk is stored

in $osDiskVhdUri, $dataDiskVhdUri1, and $dataDiskVhdUri2.



The final command creates an image named ImageName01 in resource group ResourceGroup01.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... gedatadisk