New-AzGalleryApplicationVersion

ギャラリーアプリケーションバージョンを作成または更新します。

構文

New-AzGalleryApplicationVersion
   -GalleryApplicationName <String>
   -GalleryName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Install <String>
   -Remove <String>
   [-DefaultConfigFileLink <String>]
   [-PackageFileLink <String>]
   [-PublishingProfileEndOfLifeDate <DateTime>]
   [-PublishingProfileExcludeFromLatest]
   [-ReplicaCount <Int32>]
   [-Tag <Hashtable>]
   [-TargetRegion <ITargetRegion[]>]
   [-Update <String>]
   [-PackageFileName <String>]
   [-ConfigFileName <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

ギャラリーアプリケーションバージョンを作成または更新します。

例 1: ギャラリー アプリケーションのバージョンを作成する。

$ctx = New-AzStorageContext -StorageAccountName $storAccName
$SASToken = New-AzStorageBlobSASToken -Context $ctx -Container $containerName -blob $blobName -Permission r
$storAcc = Get-AzStorageAccount -ResourceGroupName $rgName -Name $storAccName
$blob = Get-AzStorageBlob -Container $containerName -Blob $blobName -Context $storAcc.Context
$SASToken = New-AzStorageBlobSASToken -Container $containerName -Blob $blobName -Permission rwd -Context $storAcc.Context
$SASUri = $blob.ICloudBlob.Uri.AbsoluteUri + $SASToken 
New-AzGalleryApplicationVersion -ResourceGroupName $rgname -Location EastUS -GalleryName $galleryName -GalleryApplicationName $galleryApplicationName -name "0.1.0" -PackageFileLink $SASUri -Install "powershell -command 'Expand-Archive -Path package.zip -DestinationPath C:\\package\'" -Remove "del C:\\package"

ギャラリー アプリケーション バージョンの作成。 PackageFileLink の BLOB に SAS URI を使用する。

パラメーター

-AsJob

コマンドをジョブとして実行する

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConfigFileName

省略可能。 VM でダウンロードした構成ファイルを割り当てる名前。 これは 4096 文字に制限されています。 指定しない場合、構成ファイルにはギャラリー アプリケーション名に "_config" が付加されます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

省略可能。 成果物の defaultConfigurationLink は、読み取り可能なストレージ ページ BLOB である必要があります。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GalleryApplicationName

アプリケーション バージョンを作成するギャラリーアプリケーション定義の名前。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GalleryName

アプリケーション定義が存在する共有アプリケーション ギャラリーの名前。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Install

必須。 ギャラリー アプリケーションをインストールするパスと引数。 これは 4096 文字に制限されています。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

リソースの場所

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

作成するギャラリーアプリケーションバージョンの名前。 セマンティック バージョン名パターンに従う必要がある: 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります。 形式: <MajorVersion>。<MinorVersion>。<パッチ>

Type:String
Aliases:GalleryApplicationVersionName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

コマンドを非同期的に実行する

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

必須。 成果物の mediaLink は、読み取り可能なストレージ ページ BLOB である必要があります。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageFileName

省略可能。 VM でダウンロードしたパッケージ ファイルを割り当てる名前。 これは 4096 文字に制限されています。 指定しない場合、パッケージ ファイルにはギャラリー アプリケーション名と同じ名前が付けられます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishingProfileEndOfLifeDate

ギャラリー イメージ バージョンの有効期間の終了日。 このプロパティは、使用停止の目的で使用できます。 このプロパティは更新可能です。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishingProfileExcludeFromLatest

true に設定すると、イメージ定義の最新バージョンからデプロイされた Virtual Machines では、このイメージ バージョンは使用されません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Remove

必須。 ギャラリー アプリケーションを削除するパスと引数。 これは 4096 文字に制限されています。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaCount

リージョンごとに作成されるイメージ バージョンのレプリカの数。 regionReplicaCount が指定されていない場合、このプロパティはリージョンに対して有効になります。 このプロパティは更新可能です。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

リソース グループの名前。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

リソース タグ

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetRegion

イメージ バージョンがレプリケートされるターゲット リージョン。 このプロパティは更新可能です。 構築するには、TARGETREGION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

Type:ITargetRegion[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Update

省略可能。 ギャラリー アプリケーションを更新するためのパスと引数。 存在しない場合、更新操作は以前のバージョンで remove コマンドを呼び出し、ギャラリー アプリケーションの現在のバージョンでコマンドをインストールします。 これは 4096 文字に制限されています。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

出力

IGalleryApplicationVersion

メモ

別名

複合パラメーターのプロパティ

以下で説明するパラメーターを作成するには、適切なプロパティを含むハッシュ テーブルを作成します。 ハッシュ テーブルの詳細については、Get-Help about_Hash_Tablesを実行します。

TARGETREGION <ITargetRegion[]>: イメージ バージョンがレプリケートされるターゲット リージョン。 このプロパティは更新可能です。

  • Name <String>: リージョンの名前。
  • [EncryptionDataDiskImage <IDataDiskImageEncryption[]>]: データ ディスク イメージの暗号化仕様の一覧。
    • Lun <Int32>: このプロパティは、データ ディスクの論理ユニット番号を指定します。 この値は、仮想マシン内のデータ ディスクを識別するために使用されるため、仮想マシンに接続されているデータ ディスクごとに一意である必要があります。
    • [DiskEncryptionSetId <String>]: ディスク暗号化セットのリソース ID を含む相対 URI。
  • [OSDiskImageDiskEncryptionSetId <String>]: ディスク暗号化セットのリソース ID を含む相対 URI。
  • [RegionalReplicaCount <Int32?>]: リージョンごとに作成されるイメージ バージョンのレプリカの数。 このプロパティは更新可能です。
  • [SecurityProfileConfidentialVMEncryptionType <ConfidentialVMEncryptionType?>]: 機密 VM 暗号化の種類
  • [SecurityProfileSecureVMDiskEncryptionSetId <String>]: セキュリティで保護された VM ディスク暗号化セット ID
  • [StorageAccountType <StorageAccountType?>]: イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。