Share via

Publish-AzVMDscConfiguration

  • 參考
模組:
Az.Compute

將 DSC 文稿上傳至 Azure Blob 記憶體。

Syntax

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>]

Description

Publish-AzVMDscConfiguration Cmdlet 會將 Desired 狀態設定 （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"

此命令會為指定的腳本和任何相依資源模組建立.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

指定要包含在組態封存中的檔案或目錄路徑。 它會連同組態一起下載到虛擬機。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationDataPath

指定 .psd1 檔案的路徑，指定組態的數據。 這會新增至組態封存，然後傳遞至組態函式。 它會由透過 Set-AzVMDscExtension Cmdlet 提供的組態數據路徑覆寫

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationPath

指定包含一或多個組態的檔案路徑。 檔案可以是 Windows PowerShell 腳本 （.ps1） 檔案或 Windows PowerShell 模組 （.psm1） 檔案。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContainerName

指定上傳組態的 Azure 記憶體容器名稱。

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

強制命令執行，而不要求使用者確認。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputArchivePath

指定要寫入組態封存的本機.zip檔案路徑。 使用此參數時，組態腳本不會上傳至 Azure Blob 記憶體。

Type:String
Aliases:ConfigurationArchivePath
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

指定包含記憶體帳戶的資源群組名稱。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipDependencyDetection

指出此 Cmdlet 會從組態封存中排除 DSC 資源相依性。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountName

指定用來將組態腳本上傳至 ContainerName 參數所指定的容器的 Azure 儲存器帳戶名稱。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpointSuffix

指定儲存端點的後綴。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

String[]

輸出

String