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>]
Description
Publish-AzVMDscConfiguration Cmdlet 會將所需狀態設定 (DSC) 腳本上傳至 Azure Blob 儲存體,稍後可以使用 Set-AzVMDscExtension Cmdlet 套用至 Azure 虛擬機器。
範例
範例 1:建立 .zip 套件,並將其上傳至 Azure 儲存體
Publish-AzVMDscConfiguration ".\MyConfiguration.ps1"
此命令會為指定的腳本和任何相依資源模組建立 .zip 套件,並將它上傳至 Azure 儲存體。
範例 2:建立 .zip 套件並將其儲存到本機檔案
Publish-AzVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"
此指令會為指定的 Script 及任何相依資源模組建立 .zip 套件,並將它儲存在名為 的本端檔案中。\MyConfiguration.ps1.zip。
範例 3:將組態新增至封存,然後將其上傳至儲存體
Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection
此命令會將名為 Sample.ps1 的組態新增至組態封存,以上傳至 Azure 儲存體,並略過相依資源模組。
範例 4:將組態和組態資料新增至封存,然後將其上傳至儲存體
Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"
此命令會將名為 Sample.ps1 的組態和名為 SampleData.psd1 的組態資料新增至組態封存,以上傳至 Azure 儲存體。
範例 5:將組態、組態資料和其他內容新增至封存,然後將其上傳至儲存
Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"
此命令會將名為 Sample.ps1的組態、組態資料 SampleData.psd1 和其他內容新增至組態封存,以上傳至 Azure 儲存體。
參數
-AdditionalPath
指定要包含在配置保存檔中的檔案或目錄的路徑。
它會與組態一起下載到虛擬機器。
參數屬性
| 類型: | String[]
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ConfigurationDataPath
指定指定組態資料的 .psd1 檔案路徑。
這會新增至配置封存,然後傳遞至配置函式。
它會被透過 Set-AzVMDscExtension Cmdlet 提供的組態資料路徑覆寫
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ConfigurationPath
指定包含一或多個組態的檔案路徑。
檔案可以是 Windows PowerShell 腳本 (.ps1) 檔案或 Windows PowerShell 模組 (.psm1) 檔案。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContainerName
指定組態上傳至的 Azure 儲存體容器名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
UploadArchive
| Position: | 4 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
強制命令執行,而不要求使用者確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OutputArchivePath
指定要寫入組態保存檔的本機 .zip 檔案的路徑。
使用此參數時,組態指令碼不會上傳至 Azure Blob 儲存體。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 組態歸檔路徑 |
參數集
CreateArchive
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ResourceGroupName
指定包含儲存體帳戶之資源群組名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
UploadArchive
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SkipDependencyDetection
表示此 Cmdlet 會從組態封存中排除 DSC 資源相依性。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-StorageAccountName
指定用來將組態指令碼上傳至 ContainerName 參數所指定容器的 Azure 儲存體帳戶名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
UploadArchive
| Position: | 3 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-StorageEndpointSuffix
指定儲存端點的尾碼。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
UploadArchive
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。
指令未執行。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸出