你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Publish-AzVMDscConfiguration
将 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
指定要包含在配置存档中的文件或目录的路径。 它将连同配置一起下载到虚拟机。
类型: | String[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-ConfigurationDataPath
指定指定配置数据的 .psd1 文件的路径。 这会添加到配置存档,然后传递给配置函数。 它被通过 Set-AzVMDscExtension cmdlet 提供的配置数据路径覆盖
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-ConfigurationPath
指定包含一个或多个配置的文件的路径。 该文件可以是 Windows PowerShell 脚本 (.ps1) 文件或 Windows PowerShell 模块 (.psm1) 文件。
类型: | String |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ContainerName
指定将配置上传到的 Azure 存储容器的名称。
类型: | String |
Position: | 4 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Force
强制运行命令而不要求用户确认。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-OutputArchivePath
指定要将配置存档写入到的本地.zip文件的路径。 使用此参数时,配置脚本不会上传到 Azure Blob 存储。
类型: | String |
别名: | ConfigurationArchivePath |
Position: | 2 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-ResourceGroupName
指定包含存储帐户的资源组的名称。
类型: | String |
Position: | 2 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-SkipDependencyDetection
指示此 cmdlet 从配置存档中排除 DSC 资源依赖项。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-StorageAccountName
指定用于将配置脚本上传到 ContainerName 参数指定的容器的 Azure 存储帐户名称。
类型: | String |
Position: | 3 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-StorageEndpointSuffix
指定存储终结点的后缀。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
String[]