你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 cmdlet 将 Desired State Configuration （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