Publish-AzureVMDscConfiguration
将所需的状态配置脚本发布到 Azure Blob 存储。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
UploadArchive (默认值)
Publish-AzureVMDscConfiguration
[-ConfigurationPath] <String>
[-ContainerName <String>]
[-Force]
[-StorageContext <AzureStorageContext>]
[-StorageEndpointSuffix <String>]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-PassThru]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateArchive
Publish-AzureVMDscConfiguration
[-ConfigurationPath] <String>
[-Force]
[-ConfigurationArchivePath <String>]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-PassThru]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Publish-AzureVMDscConfiguration cmdlet 将所需的状态配置脚本发布到 Azure Blob 存储,稍后可以使用 Set-AzureVMDscExtension cmdlet 将脚本应用到 Azure 虚拟机。
示例
示例 1:将状态配置脚本发布到 Blob 存储
PS C:\> Publish-AzureVMDscConfiguration .\MyConfiguration.ps1
此命令为给定脚本和任何依赖资源模块创建.zip包,并将其上传到 Azure 存储。
示例 2:将状态配置脚本发布到本地文件
PS C:\> Publish-AzureVMDscConfiguration .\MyConfiguration.ps1 -ConfigurationArchivePath .\MyConfiguration.ps1.zip
此命令为给定脚本和任何依赖资源模块创建.zip包,并将其存储在本地文件 .\MyConfiguration.ps1.zip中。
参数
-AdditionalPath
指定其他路径的数组。
参数属性
| 类型: | String[]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-ConfigurationArchivePath
指定此 cmdlet 写入配置存档的本地.zip文件的路径。
如果使用此参数,则配置脚本不会上传到 Azure Blob 存储。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateArchive
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-ConfigurationDataPath
指定配置数据路径。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-ConfigurationPath
指定包含一个或多个配置的文件的路径。
该文件可以是 Windows PowerShell 脚本(.ps1 文件)、模块(.psm1 文件)或存档(.zip文件),其中包含一组 Windows PowerShell 模块,每个模块都位于单独的目录中。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ContainerName
指定将配置上传到的 Azure 存储容器的名称。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UploadArchive
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Force
强制运行命令而不要求用户确认。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
指定此 cmdlet 如何响应信息事件。
此参数的可接受值为:
- 继续
- 忽略
- 询问
- SilentlyContinue
- 停止
- Suspend
| 类型: | ActionPreference
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | infa |
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
指定信息变量。
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 四 |
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PassThru
返回一个代表你所处理的项目的对象。
默认情况下,此 cmdlet 将不产生任何输出。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。
如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。
参数属性
| 类型: | AzureSMProfile
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SkipDependencyDetection
指示此 cmdlet 跳过依赖项检测。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-StorageContext
指定 Azure 存储上下文,该上下文提供用于将配置脚本上传到 ContainerName 参数指定的容器的安全设置。
此上下文提供对容器的写入访问权限。
参数属性
| 类型: | AzureStorageContext
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UploadArchive
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-StorageEndpointSuffix
指定存储终结点的后缀,例如,core.contoso.net
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UploadArchive
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。
cmdlet 未运行。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。