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 |
-DefaultConfigFileLink
省略可能。 成果物の 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 |
-PackageFileLink
必須。 成果物の 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 |
出力
メモ
別名
複合パラメーターのプロパティ
以下で説明するパラメーターを作成するには、適切なプロパティを含むハッシュ テーブルを作成します。 ハッシュ テーブルの詳細については、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?>]
: イメージの格納に使用するストレージ アカウントの種類を指定します。 このプロパティは更新できません。
Azure PowerShell
フィードバック
https://aka.ms/ContentUserFeedback。
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください:フィードバックの送信と表示