英語で読む

次の方法で共有

Publish-AzVMDscConfiguration

  • リファレンス
モジュール:
Az.Compute

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 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[]
配置: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[]

出力