다음을 통해 공유


Set-AzureRMVMSqlServerExtension

가상 머신에서 Azure SQL Server 확장을 설정합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 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>]

Description

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 백업 설정을 지정합니다. AutoBackupSettings 개체를 만들려면 New-AzureVMSqlServerAutoBackupConfig cmdlet을 사용합니다.

형식:AutoBackupSettings
Position:6
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-AutoPatchingSettings

자동 SQL Server 패치 설정을 지정합니다. AutoPatchingSettings 개체를 만들려면 New-AzureVMSqlServerAutoPatchingConfig cmdlet을 사용합니다.

형식:AutoPatchingSettings
Position:5
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-KeyVaultCredentialSettings

형식:KeyVaultCredentialSettings
Position:7
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Location

가상 머신의 위치를 지정합니다.

형식:String
Position:8
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

SQL Server 확장의 이름을 지정합니다.

형식:String
Position:4
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceGroupName

가상 머신의 리소스 그룹의 이름을 지정합니다.

형식:String
Position:2
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Version

SQL Server 확장의 버전을 지정합니다.

형식:String
별칭:HandlerVersion
Position:1
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-VMName

이 cmdlet이 SQL Server 확장을 설정하는 가상 머신의 이름을 지정합니다.

형식:String
Position:3
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

출력

PSAzureOperationResponse