你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureRmVmssOsProfile
设置 VMSS 操作系统配置文件属性。
警告
AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新，建议用户从 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 |
输入
Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]