Publish-AzVMDscConfiguration
DSC スクリプトを Azure BLOB ストレージにアップロードします。
構文
UploadArchive (既定)
Publish-AzVMDscConfiguration
[-ResourceGroupName] <String>
[-ConfigurationPath] <String>
[[-ContainerName] <String>]
[-StorageAccountName] <String>
[-StorageEndpointSuffix <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateArchive
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 Storage にアップロードします。このスクリプトは、後で 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[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ConfigurationDataPath
構成のデータを指定する .psd1 ファイルのパスを指定します。
これは構成アーカイブに追加され、構成関数に渡されます。
Set-AzVMDscExtension コマンドレットを介して指定された構成データ パスによって上書きされます
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ConfigurationPath
1 つ以上の構成を含むファイルのパスを指定します。
ファイルには、Windows PowerShell スクリプト (.ps1) ファイルまたは Windows PowerShell モジュール (.psm1) ファイルを指定できます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ContainerName
構成のアップロード対象となる Azure ストレージ コンテナーの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
UploadArchive
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OutputArchivePath
構成アーカイブを書き込むローカル .zip ファイルのパスを指定します。
このパラメーターを使用すると、構成スクリプトは Azure BLOB ストレージにアップロードされません。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ConfigurationArchivePath |
パラメーター セット
CreateArchive
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ResourceGroupName
ストレージ アカウントを含むリソース グループの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
UploadArchive
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SkipDependencyDetection
このコマンドレットが構成アーカイブから DSC リソースの依存関係を除外することを示します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StorageAccountName
ContainerName パラメーターで指定されたコンテナーに構成スクリプトをアップロードするために使用する Azure ストレージ アカウント名を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
UploadArchive
| 配置: | 3 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-StorageEndpointSuffix
ストレージ エンドポイントのサフィックスを指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
UploadArchive
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力