Udostępnij za pośrednictwem

Set-AzureRMVMSqlServerExtension

  • Odwołanie
Moduł:
AzureRM.Compute

Ustawia rozszerzenie programu Azure SQL Server na maszynie wirtualnej.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Set-AzureRMVMSqlServerExtension
   [[-Version] <String>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-Name] <String>]
   [[-AutoPatchingSettings] <AutoPatchingSettings>]
   [[-AutoBackupSettings] <AutoBackupSettings>]
   [[-KeyVaultCredentialSettings] <KeyVaultCredentialSettings>]
   [[-Location] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureRmVMSqlServerExtension ustawia rozszerzenie serwera AzureSQL na maszynie wirtualnej.

Przykłady

Przykład 1. Ustawianie ustawień automatycznego stosowania poprawek na maszynie wirtualnej

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

Pierwsze polecenie tworzy obiekt konfiguracji przy użyciu polecenia cmdlet New-AzureVMSqlServerAutoPatchingConfig . Polecenie przechowuje konfigurację w zmiennej $AutoPatchingConfig. Drugie polecenie pobiera maszynę wirtualną o nazwie VirtualMachine11 w usłudze o nazwie Service02 przy użyciu polecenia cmdlet Get-AzureRmVM. Polecenie przekazuje ten obiekt do bieżącego polecenia cmdlet przy użyciu operatora potoku. Bieżące polecenie cmdlet ustawia ustawienia automatycznego stosowania poprawek w $AutoPatchingConfig dla maszyny wirtualnej. Polecenie przekazuje maszynę wirtualną do polecenia cmdlet Update-AzureRmVM.

Przykład 2. Ustawianie ustawień automatycznej kopii zapasowej na maszynie wirtualnej

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

Pierwsze polecenie tworzy obiekt konfiguracji przy użyciu polecenia cmdlet New-AzureVMSqlServerAutoBackupConfig . Polecenie przechowuje konfigurację w zmiennej $AutoBackupConfig. Drugie polecenie pobiera maszynę wirtualną o nazwie VirtualMachine11 w usłudze o nazwie Service02, a następnie przekazuje ją do bieżącego polecenia cmdlet. Bieżące polecenie cmdlet ustawia ustawienia automatycznej kopii zapasowej w $AutoBackupConfig dla maszyny wirtualnej. Polecenie przekazuje maszynę wirtualną do polecenia cmdlet Update-AzureRmVM.

Przykład 3. Wyłączanie rozszerzenia programu SQL Server na maszynie wirtualnej

PS C:\> Get-AzureRmVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzureRmVMSqlServerExtension -Disable

To polecenie pobiera maszynę wirtualną o nazwie VirtualMachine08 w usłudze Service03, a następnie przekazuje ją do bieżącego polecenia cmdlet. Polecenie wyłącza rozszerzenie maszyny wirtualnej programu SQL Server na tej maszynie wirtualnej.

Przykład 4. Odinstalowywanie rozszerzenia programu SQL Server na określonej maszynie wirtualnej

PS C:\> Get-AzureRmVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzureRmVMSqlServerExtension -Uninstall

To polecenie pobiera maszynę wirtualną o nazwie VirtualMachine08 w usłudze Service03, a następnie przekazuje ją do bieżącego polecenia cmdlet. Polecenie powoduje odinstalowanie rozszerzenia maszyny wirtualnej programu SQL Server na tej maszynie wirtualnej.

Parametry

-AutoBackupSettings

Określa ustawienia automatycznej kopii zapasowej programu SQL Server. Aby utworzyć obiekt AutoBackupSettings , użyj polecenia cmdlet New-AzureVMSqlServerAutoBackupConfig.

Typ:AutoBackupSettings
Position:6
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-AutoPatchingSettings

Określa ustawienia automatycznego stosowania poprawek programu SQL Server. Aby utworzyć obiekt AutoPatchingSettings , użyj polecenia cmdlet New-AzureVMSqlServerAutoPatchingConfig.

Typ:AutoPatchingSettings
Position:5
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-KeyVaultCredentialSettings

Typ:KeyVaultCredentialSettings
Position:7
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Location

Określa lokalizację maszyny wirtualnej.

Typ:String
Position:8
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę rozszerzenia programu SQL Server.

Typ:String
Position:4
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów maszyny wirtualnej.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Version

Określa wersję rozszerzenia programu SQL Server.

Typ:String
Aliasy:HandlerVersion
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMName

Określa nazwę maszyny wirtualnej, na której to polecenie cmdlet ustawia rozszerzenie programu SQL Server.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Dane wyjściowe

PSAzureOperationResponse