Publish-AzVMDscConfiguration
DSC スクリプトを Azure BLOB ストレージにアップロードします。
構文
Publish-AzVMDscConfiguration
[-ResourceGroupName] <String>
[-ConfigurationPath] <String>
[[-ContainerName] <String>]
[-StorageAccountName] <String>
[-StorageEndpointSuffix <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Publish-AzVMDscConfiguration
[-ConfigurationPath] <String>
[[-OutputArchivePath] <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Publish-AzVMDscConfiguration コマンドレットは Desired State Configuration (DSC) スクリプトを Azure BLOB ストレージにアップロードします。これは後で Set-AzVMDscExtension コマンドレットを使用して Azure 仮想マシンに適用できます。
例
例 1: .zip パッケージを作成して Azure Storage にアップロードする
Publish-AzVMDscConfiguration ".\MyConfiguration.ps1"
このコマンドは、特定のスクリプトと依存リソース モジュールの.zip パッケージを作成し、Azure Storage にアップロードします。
例 2: .zip パッケージを作成し、ローカル ファイルに格納する
Publish-AzVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"
このコマンドは、指定されたスクリプトと依存リソース モジュールの.zip パッケージを作成し、.\MyConfiguration.ps1.zip という名前のローカル ファイルに格納します。
例 3: アーカイブに構成を追加し、ストレージにアップロードする
Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection
このコマンドは、Sample.ps1 という名前の構成を構成アーカイブに追加して Azure Storage にアップロードし、依存リソース モジュールをスキップします。
例 4: 構成データと構成データをアーカイブに追加し、ストレージにアップロードする
Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"
このコマンドは、Sample.ps1 という名前の構成と SampleData.psd1 という名前の構成データを構成アーカイブに追加して、Azure Storage にアップロードします。
例 5: 構成、構成データ、および追加のコンテンツをアーカイブに追加し、ストレージにアップロードする
Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"
このコマンドは、Sample.ps1 という名前の構成、構成データ SampleData.psd1、および追加コンテンツを構成アーカイブに追加して、Azure Storage にアップロードします。
パラメーター
-AdditionalPath
構成アーカイブに含めるファイルまたはディレクトリのパスを指定します。 構成と共に仮想マシンにダウンロードされます。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ConfigurationDataPath
構成のデータを指定する .psd1 ファイルのパスを指定します。 これは構成アーカイブに追加され、構成関数に渡されます。 Set-AzVMDscExtension コマンドレットを使用して指定された構成データ パスによって上書きされます
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ConfigurationPath
1 つ以上の構成を含むファイルのパスを指定します。 ファイルには、Windows PowerShell スクリプト (.ps1) ファイルまたは Windows PowerShell モジュール (.psm1) ファイルを指定できます。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ContainerName
構成のアップロード対象となる Azure ストレージ コンテナーの名前を指定します。
型: | String |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OutputArchivePath
構成アーカイブを書き込むローカル .zip ファイルのパスを指定します。 このパラメーターを使用すると、構成スクリプトは Azure BLOB ストレージにアップロードされません。
型: | String |
Aliases: | ConfigurationArchivePath |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
ストレージ アカウントを含むリソース グループの名前を指定します。
型: | String |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SkipDependencyDetection
このコマンドレットが構成アーカイブから DSC リソースの依存関係を除外することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-StorageAccountName
ContainerName パラメーターで指定されたコンテナーに構成スクリプトをアップロードするために使用する Azure ストレージ アカウント名を指定します。
型: | String |
配置: | 3 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StorageEndpointSuffix
ストレージ エンドポイントのサフィックスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
String[]
出力
関連リンク
Azure PowerShell