你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Set-AzureRMVMSqlServerExtension
在虚拟机上设置 Azure SQL Server 扩展。
警告
截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源。
语法
Set-AzureRMVMSqlServerExtension
[[-Version] <String>]
[-ResourceGroupName] <String>
[-VMName] <String>
[[-Name] <String>]
[[-AutoPatchingSettings] <AutoPatchingSettings>]
[[-AutoBackupSettings] <AutoBackupSettings>]
[[-KeyVaultCredentialSettings] <KeyVaultCredentialSettings>]
[[-Location] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
Set-AzureRmVMSqlServerExtension cmdlet 在虚拟机上设置 AzureSQL 服务器扩展。
示例
示例 1:在虚拟机上设置自动修补设置
PS C:\> $AutoPatchingConfig = New-AzureVMSqlServerAutoPatchingConfig -Enable -DayOfWeek "Thursday" -MaintenanceWindowStartingHour 11 -MaintenanceWindowDuration 120 -PatchCategory "Important"
PS C:\> Get-AzureRmVM -ServiceName "Service02" -Name "VirtualMachine11" | Set-AzureRmVMSqlServerExtension -AutoPatchingSettings $AutoPatchingConfig | Update-AzureRmVM
第一个命令使用 New-AzureVMSqlServerAutoPatchingConfig cmdlet 创建配置对象。 该命令将配置存储在$AutoPatchingConfig变量中。 第二个命令使用 Get-AzureRmVM cmdlet 获取名为 Service02 的服务上的名为 VirtualMachine11 的虚拟机。 该命令使用管道运算符将该对象传递给当前 cmdlet。 当前 cmdlet 在虚拟机$AutoPatchingConfig中设置自动修补设置。 该命令将虚拟机传递到 Update-AzureRmVM cmdlet。
示例 2:在虚拟机上设置自动备份设置
PS C:\> $AutoBackupConfig = New-AzureVMSqlServerAutoBackupConfig -Enable -RetentionPeriod 10 -StorageUri $StorageUrl -StorageKey $StorageAccountKeySecure
PS C:\> Get-AzureRmVM -ServiceName "Service02" -Name "VirtualMachine11" | Set-AzureRmVMSqlServerExtension -AutoBackupSettings $AutoBackupConfig | Update-AzureRmVM
第一个命令使用 New-AzureVMSqlServerAutoBackupConfig cmdlet 创建配置对象。 该命令将配置存储在$AutoBackupConfig变量中。 第二个命令获取名为 Service02 的服务上的名为 VirtualMachine11 的虚拟机,然后将其传递给当前 cmdlet。 当前 cmdlet 在虚拟机的$AutoBackupConfig中设置自动备份设置。 该命令将虚拟机传递到 Update-AzureRmVM cmdlet。
示例 3:在虚拟机上禁用 SQL Server 扩展
PS C:\> Get-AzureRmVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzureRmVMSqlServerExtension -Disable
此命令在 Service03 上获取名为 VirtualMachine08 的虚拟机,然后将其传递给当前 cmdlet。 该命令在该虚拟机上禁用 SQL Server 虚拟机扩展。
示例 4:卸载特定虚拟机上的 SQL Server 扩展
PS C:\> Get-AzureRmVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzureRmVMSqlServerExtension -Uninstall
此命令在 Service03 上获取名为 VirtualMachine08 的虚拟机,然后将其传递给当前 cmdlet。 该命令卸载该虚拟机上的 SQL Server 虚拟机扩展。
参数
-AutoBackupSettings
指定自动 SQL Server 备份设置。 若要创建 AutoBackup设置 对象,请使用 New-AzureVMSqlServerAutoBackupConfig cmdlet。
类型: | AutoBackupSettings |
Position: | 6 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-AutoPatchingSettings
指定自动 SQL Server 修补设置。 若要创建 AutoPatching设置 对象,请使用 New-AzureVMSqlServerAutoPatchingConfig cmdlet。
类型: | AutoPatchingSettings |
Position: | 5 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-KeyVaultCredentialSettings
类型: | KeyVaultCredentialSettings |
Position: | 7 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Location
指定虚拟机的位置。
类型: | String |
Position: | 8 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Name
指定扩展的 SQL Server 的名称。
类型: | String |
Position: | 4 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-ResourceGroupName
指定虚拟机资源组的名称。
类型: | String |
Position: | 2 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Version
指定 SQL Server 扩展的版本。
类型: | String |
别名: | HandlerVersion |
Position: | 1 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-VMName
指定此 cmdlet 设置 SQL Server 扩展的虚拟机的名称。
类型: | String |
Position: | 3 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |