你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzVMOperatingSystem
在创建新虚拟机或更新虚拟机期间设置操作系统属性。
语法
Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-ProvisionVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Windows]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-DisableVMAgent]
[-EnableAutoUpdate]
[[-TimeZone] <String>]
[-WinRMHttp]
[-WinRMHttps]
[-WinRMCertificateUrl] <Uri>
[-PatchMode <String>]
[-EnableHotpatching]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzVMOperatingSystem
[-VM] <PSVirtualMachine>
[-Linux]
[[-ComputerName] <String>]
[[-Credential] <PSCredential>]
[[-CustomData] <String>]
[-PatchMode <String>]
[-DisablePasswordAuthentication]
[-AssessmentMode <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
Set-AzVMOperatingSystem cmdlet 在创建新虚拟机期间设置操作系统属性。 可以指定登录凭据、计算机名称和操作系统类型。
示例
示例 1：设置新虚拟机的操作系统属性
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
$TimeZone = "Pacific Standard Time"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone -PatchMode "AutomaticByPlatform"第一个命令将密码转换为安全字符串，然后将其存储在$SecurePassword变量中。
要了解详情，请键入 Get-Help ConvertTo-SecureString。
第二个命令为用户 FullerP 和存储在 $SecurePassword 中的密码创建凭据，然后将凭据存储在$Credential变量中。
要了解详情，请键入 Get-Help New-Object。
第三个命令获取名为 ResourceGroup11 的资源组中名为 AvailabilitySet03 的可用性集，然后将该对象存储在$AvailabilitySet变量中。
第四个命令创建虚拟机对象，然后将其存储在$VirtualMachine变量中。
该命令将名称和大小分配给虚拟机。
虚拟机属于存储在$AvailabilitySet的可用性集。
接下来的四个命令将值分配给要用于以下命令的变量。
由于可以直接在 Set-AzVMOperatingSystem 命令中指定这些字符串，因此此方法仅用于可读性。
但是，可以在脚本中使用此类方法。
最终命令设置存储在$VirtualMachine中的虚拟机的操作系统属性。
该命令使用存储在$Credential中的凭据。
该命令使用前面命令中为某些参数分配的变量。
示例 2：为启用了热修补的新虚拟机设置操作系统属性
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
$TimeZone = "Pacific Standard Time"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone -PatchMode "AutomaticByPlatform" -EnableHotPatching第一个命令将密码转换为安全字符串，然后将其存储在$SecurePassword变量中。
要了解详情，请键入 Get-Help ConvertTo-SecureString。
第二个命令为用户 FullerP 和存储在 $SecurePassword 中的密码创建凭据，然后将凭据存储在$Credential变量中。
要了解详情，请键入 Get-Help New-Object。
第三个命令获取名为 ResourceGroup11 的资源组中名为 AvailabilitySet03 的可用性集，然后将该对象存储在$AvailabilitySet变量中。
第四个命令创建虚拟机对象，然后将其存储在$VirtualMachine变量中。
该命令将名称和大小分配给虚拟机。
虚拟机属于存储在$AvailabilitySet的可用性集。
接下来的四个命令将值分配给要用于以下命令的变量。
由于可以直接在 Set-AzVMOperatingSystem 命令中指定这些字符串，因此此方法仅用于可读性。
但是，可以在脚本中使用此类方法。
最终命令设置存储在$VirtualMachine中的虚拟机的操作系统属性。
该命令使用存储在$Credential中的凭据。
该命令使用前面命令中为某些参数分配的变量。
该命令在虚拟机上启用热修补。
示例 3：为新的 Linux 虚拟机设置操作系统属性
$SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword);
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$ComputerName = "ContosoVM122"
$CustomData = "echo 'Hello World'"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -PatchMode "AutomaticByPlatform"第一个命令将密码转换为安全字符串，然后将其存储在$SecurePassword变量中。
要了解详情，请键入 Get-Help ConvertTo-SecureString。
第二个命令为用户 FullerP 和存储在 $SecurePassword 中的密码创建凭据，然后将凭据存储在$Credential变量中。
要了解详情，请键入 Get-Help New-Object。
第三个命令获取名为 ResourceGroup11 的资源组中名为 AvailabilitySet03 的可用性集，然后将该对象存储在$AvailabilitySet变量中。
第四个命令创建虚拟机对象，然后将其存储在$VirtualMachine变量中。
该命令将名称和大小分配给虚拟机。
虚拟机属于存储在$AvailabilitySet的可用性集。
接下来的两个命令将值分配给在以下命令中使用的变量。
最终命令设置存储在$VirtualMachine中的虚拟机的操作系统属性。
该命令使用存储在$Credential中的凭据。
该命令使用前面命令中为某些参数分配的变量。
该命令将虚拟机上的修补模式值设置为“AutomaticByPlatform”。
参数
-AssessmentMode
虚拟机的自动评估模式值。 可能的值是 ImageDefault 和 AutomaticByPlatform。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
指定计算机的名称。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
将虚拟机的用户名和密码指定为 PSCredential 对象。
若要获取凭据，请使用 Get-Credential cmdlet。
要了解详情，请键入 Get-Help Get-Credential。
| Type: | PSCredential |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CustomData
指定要传递给虚拟机的字符串。 有关详细信息，请参阅 Azure VM 上的自定义数据。 注意：不建议将敏感信息存储在自定义数据中。
| 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 |
-DisablePasswordAuthentication
指示此 cmdlet 禁用密码身份验证。
| Type: | SwitchParameter |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisableVMAgent
禁用预配 VM 代理。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAutoUpdate
指示此 cmdlet 启用自动更新。
| Type: | SwitchParameter |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableHotpatching
使客户无需重新启动即可修补其 Azure VM。 对于 enableHotpatching，必须将“provisionVMAgent”设置为 true，并且“patchMode”必须设置为“AutomaticByPlatform”。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Linux
指示操作系统的类型为 Linux。
| Type: | SwitchParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PatchMode
指定对 IaaS 虚拟机进行来宾内修补的模式。
可能的值为：
AutomaticByPlatform - 虚拟机的修补程序安装将由 Azure 管理。 与 -Windows 或 -Linux 一起使用。 需要 -ProvisionVMAgent。 在与 -Windows 一起使用时需要 -EnableAutoUpdate。
AutomaticByOS - 虚拟机的修补程序安装将由 OS 管理。 与 -Windows 一起使用。 需要 -ProvisionVMAgent 和 -EnableAutoUpdate。
手动 - 控制对虚拟机的修补程序的应用程序。 与 -Windows 一起使用。 需要 -ProvisionVMAgent。
ImageDefault - 由 OS 映像上的默认设置管理的修补程序安装。 与 -Linux 一起使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProvisionVMAgent
指示设置要求在虚拟机上安装虚拟机代理。
| Type: | SwitchParameter |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TimeZone
指定虚拟机的时区。 例如“太平洋标准时间”。
可能的值可以从 TimeZoneInfo.GetSystemTimeZones 返回的时区 TimeZoneInfo.Id 值。
| Type: | String |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VM
指定要在其中设置操作系统属性的本地虚拟机对象。 若要获取虚拟机对象，请使用 Get-AzVM cmdlet。 使用 New-AzVMConfig cmdlet 创建虚拟机对象。
| Type: | PSVirtualMachine |
| Aliases: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Windows
指示操作系统的类型为 Windows。
| Type: | SwitchParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WinRMCertificateUrl
指定 WinRM 证书的 URI。 这需要存储在密钥库中。
| Type: | Uri |
| Position: | 10 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WinRMHttp
指示此操作系统使用 HTTP WinRM。
| Type: | SwitchParameter |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WinRMHttps
指示此操作系统使用 HTTPS WinRM。
| Type: | SwitchParameter |
| Position: | 9 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
输入
输出
相关链接
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈