Publish-AzureVMDscConfiguration
目的の状態構成スクリプトを Azure BLOB ストレージに発行します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
Publish-AzureVMDscConfiguration
[-ConfigurationPath] <String>
[-ContainerName <String>]
[-Force]
[-StorageContext <AzureStorageContext>]
[-StorageEndpointSuffix <String>]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-PassThru]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Publish-AzureVMDscConfiguration
[-ConfigurationPath] <String>
[-Force]
[-ConfigurationArchivePath <String>]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-PassThru]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Publish-AzureVMDscConfiguration コマンドレットは、必要な状態構成スクリプトを Azure BLOB ストレージに発行します。これは後で Set-AzureVMDscExtension コマンドレットを使用して Azure 仮想マシンに適用できます。
例
例 1: 状態構成スクリプトを BLOB ストレージに発行する
PS C:\> Publish-AzureVMDscConfiguration .\MyConfiguration.ps1
このコマンドは、特定のスクリプトと依存リソース モジュールの.zip パッケージを作成し、Azure Storage にアップロードします。
例 2: 状態構成スクリプトをローカル ファイルに発行する
PS C:\> Publish-AzureVMDscConfiguration .\MyConfiguration.ps1 -ConfigurationArchivePath .\MyConfiguration.ps1.zip
このコマンドは、特定のスクリプトと依存リソース モジュールの.zip パッケージを作成し、ローカル ファイル .\MyConfiguration.ps1.zip に格納します。
パラメーター
-AdditionalPath
追加のパスの配列を指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ConfigurationArchivePath
このコマンドレットが構成アーカイブを書き込むローカル .zip ファイルのパスを指定します。 このパラメーターを使用する場合、構成スクリプトは Azure BLOB ストレージにアップロードされません。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ConfigurationDataPath
構成データ パスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ConfigurationPath
1 つ以上の構成を含むファイルのパスを指定します。 ファイルには、Windows PowerShell スクリプト (.ps1 ファイル)、モジュール (.psm1 ファイル)、または一連の Windows PowerShell モジュールを含むアーカイブ (.zip ファイル) を指定できます。各モジュールは別のディレクトリに配置されます。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ContainerName
構成のアップロード対象となる Azure ストレージ コンテナーの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- 阻止
- [中断]
型: | ActionPreference |
Aliases: | infa |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
型: | String |
Aliases: | iv |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PassThru
作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SkipDependencyDetection
このコマンドレットが依存関係の検出をスキップすることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-StorageContext
ContainerName パラメーターで指定されたコンテナーに構成スクリプトをアップロードするために使用するセキュリティ設定を提供する Azure ストレージ コンテキストを指定します。 このコンテキストは、コンテナーへの書き込みアクセスを提供します。
型: | AzureStorageContext |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StorageEndpointSuffix
ストレージ エンドポイントのサフィックスを指定します (例: core.contoso.net
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |