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

Set-AzureRmVmssOsProfile

设置 VMSS 操作系统配置文件属性。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

Set-AzureRmVmssOsProfile
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-ComputerNamePrefix] <String>]
   [[-AdminUsername] <String>]
   [[-AdminPassword] <String>]
   [[-CustomData] <String>]
   [[-WindowsConfigurationProvisionVMAgent] <Boolean>]
   [[-WindowsConfigurationEnableAutomaticUpdate] <Boolean>]
   [[-TimeZone] <String>]
   [[-AdditionalUnattendContent] <AdditionalUnattendContent[]>]
   [[-Listener] <WinRMListener[]>]
   [[-LinuxConfigurationDisablePasswordAuthentication] <Boolean>]
   [[-PublicKey] <SshPublicKey[]>]
   [[-Secret] <VaultSecretGroup[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzureRmVmssOsProfile cmdlet 设置虚拟机规模集操作系统配置文件属性。

示例

示例 1:设置 VMSS 的操作系统配置文件属性

PS C:\> Set-AzureRmVmssOSProfile -VirtualMachineScaleSet "ContosoVMSS" -ComputerNamePrefix "Test" -AdminUsername $AdminUsername -AdminPassword $AdminPassword

此命令为属于名为 ContosoVMSS 的 VMSS 的虚拟机设置操作系统配置文件属性。 该命令将 VMSS 中所有虚拟机实例的计算机名称前缀设置为测试并提供管理员用户名和密码。

参数

-AdditionalUnattendContent

指定无人参与的内容对象。 可以使用 Add-AzureRmVMAdditionalUnattendContent 创建对象。

类型:AdditionalUnattendContent[]
Position:8
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-AdminPassword

指定要用于 VMSS 中的所有虚拟机实例的管理员密码。

类型:String
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-AdminUsername

指定要用于 VMSS 中的所有虚拟机实例的管理员帐户名称。

类型:String
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ComputerNamePrefix

指定 VMSS 中所有虚拟机实例的计算机名称前缀。 计算机名称长度必须为 1 到 15 个字符。

类型:String
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CustomData

指定自定义数据的 base-64 编码字符串。 这已解码为作为虚拟机上的文件保存的二进制数组。 二进制数组的最大长度为 65535 字节。

类型:String
Position:4
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LinuxConfigurationDisablePasswordAuthentication

指示此 cmdlet 禁用密码身份验证。

类型:Nullable<T>[Boolean]
Position:10
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Listener

指定 Windows 远程管理(WinRM)侦听器。 这将启用远程 Windows PowerShell。 可以使用 Add-AzureRmVmssWinRMListener cmdlet 创建侦听器。

类型:WinRMListener[]
Position:9
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PublicKey

指定 Secure Shell (SSH) 公钥对象。 可以使用 Add-AzureRmVMSshPublicKey cmdlet 创建对象。

类型:SshPublicKey[]
Position:11
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Secret

指定包含要放置在虚拟机上的证书引用的机密对象。 可以使用 Add-AzureRmVmssSecret cmdlet 创建机密对象。

类型:VaultSecretGroup[]
Position:12
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-TimeZone

指定虚拟机的时区。

类型:String
Position:7
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-VirtualMachineScaleSet

指定 VMSS 对象。 可以使用 New-AzureRmVmssConfig cmdlet 创建对象。

类型:PSVirtualMachineScaleSet
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WindowsConfigurationEnableAutomaticUpdate

指示是否为 VMSS 中的虚拟机启用了自动更新。

类型:Nullable<T>[Boolean]
Position:6
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WindowsConfigurationProvisionVMAgent

指示是否应在 VMSS 中的虚拟机上预配虚拟机代理。

类型:Nullable<T>[Boolean]
Position:5
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输入

PSVirtualMachineScaleSet

String

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

AdditionalUnattendContent[]

WinRMListener[]

SshPublicKey[]

VaultSecretGroup[]

输出

PSVirtualMachineScaleSet