Uppdatera SQL-resursprovidernUpdate the SQL resource provider

Viktigt

Innan du uppdaterar resurs leverantören läser du viktig information om nya funktioner, korrigeringar och eventuella kända problem som kan påverka din distribution.Before updating the resource provider, review the release notes to learn about new functionality, fixes, and any known issues that could affect your deployment. I viktig information anges också den minsta Azure Stack Hub-version som krävs för resurs leverantören.The release notes also specify the minimum Azure Stack Hub version required for the resource provider.

En ny SQL Resource-Provider kan släppas när Azure Stack Hub uppdateras till en ny version.A new SQL resource provider might be released when Azure Stack Hub is updated to a new build. Även om den befintliga resurs leverantören fortsätter att fungera, rekommenderar vi att du uppdaterar till den senaste versionen så snart som möjligt.Although the existing resource provider continues to work, we recommend updating to the latest build as soon as possible.

Azure Stack Hub-version som stödsSupported Azure Stack Hub version SQL RP-versionSQL RP version Windows Server som RP-tjänsten körs påWindows Server that RP service is running on
2008, 20052008, 2005 SQL RP-version 1.1.93.1SQL RP version 1.1.93.1 Microsoft AzureStacke-tillägg RP Windows ServerMicrosoft AzureStack Add-on RP Windows Server
2005, 2002, 19102005, 2002, 1910 SQL RP-version 1.1.47.0SQL RP version 1.1.47.0 Windows Server 2016 Data Center-Server CoreWindows Server 2016 Datacenter - Server Core
19081908 SQL RP-version 1.1.33.0SQL RP version 1.1.33.0 Windows Server 2016 Data Center-Server CoreWindows Server 2016 Datacenter - Server Core

Uppdateringen av SQL Resource Provider är kumulativ.SQL resource provider update is cumulative. När du uppdaterar från en gammal version kan du uppdatera till den senaste versionen direkt.When updating from an old version, you can directly update to the latest version.

Om du vill uppdatera resurs leverantören använder du UpdateSQLProvider.ps1 -skriptet.To update the resource provider, use the UpdateSQLProvider.ps1 script. Använd ditt tjänst konto med lokal administratörs behörighet och är ägare till prenumerationen.Use your service account with local administrative rights and is an owner of the subscription. Det här uppdaterings skriptet ingår i nedladdningen av resurs leverantören.This update script is included with the download of the resource provider.

Uppdaterings processen liknar den process som används för att distribuera resurs leverantören.The update process is similar to the process used to Deploy the resource provider. Uppdaterings skriptet använder samma argument som DeploySqlProvider.ps1-skriptet och du måste ange certifikat information.The update script uses the same arguments as the DeploySqlProvider.ps1 script, and you'll need to provide certificate information.

Uppdatera skript processerUpdate script processes

UpdateSQLProvider.ps1 skriptet skapar en ny virtuell dator (VM) med den senaste operativ system avbildningen, distribuerar den senaste resurs leverantörs koden och migrerar inställningarna från den gamla resurs leverantören till den nya resurs leverantören.The UpdateSQLProvider.ps1 script creates a new virtual machine (VM) with the latest OS image, deploy the latest resource provider code, and migrates the settings from the old resource provider to the new resource provider.

Anteckning

Vi rekommenderar att du hämtar den senaste Windows Server 2016 Core-avbildningen eller Microsoft AzureStack-tillägget RP Windows Server-avbildning från Marketplace-hantering.We recommend that you download the latest Windows Server 2016 Core image or Microsoft AzureStack Add-on RP Windows Server image from Marketplace Management. Om du behöver installera en uppdatering kan du placera ett enda MSU-paket i den lokala beroende sökvägen.If you need to install an update, you can place a single MSU package in the local dependency path. Skriptet fungerar inte om det finns mer än en MSU-fil på den här platsen.The script will fail if there's more than one MSU file in this location.

När UpdateSQLProvider.ps1 skriptet skapar en ny virtuell dator migrerar skriptet följande inställningar från den gamla VM-providern:After the UpdateSQLProvider.ps1 script creates a new VM, the script migrates the following settings from the old resource provider VM:

  • databas informationdatabase information
  • information om värd Serverhosting server information
  • obligatorisk DNS-postrequired DNS record

Uppdatera skript parametrarUpdate script parameters

Du kan ange följande parametrar från kommando raden när du kör UpdateSQLProvider.ps1 PowerShell-skriptet.You can specify the following parameters from the command line when you run the UpdateSQLProvider.ps1 PowerShell script. Om du inte gör det, eller om någon parameter validering Miss lyckas, uppmanas du att ange de parametrar som krävs.If you don't, or if any parameter validation fails, you're prompted to provide the required parameters.

ParameternamnParameter name BeskrivningDescription Kommentar eller standardvärdeComment or default value
CloudAdminCredentialCloudAdminCredential Autentiseringsuppgifterna för moln administratören, som krävs för att komma åt den privilegierade slut punkten.The credential for the cloud admin, necessary for accessing the privileged endpoint. ObligatorisktRequired
AzCredentialAzCredential Autentiseringsuppgifterna för administratörs kontot för Azure Stack Hub-tjänsten.The credentials for the Azure Stack Hub service admin account. Använd samma autentiseringsuppgifter som du använde för att distribuera Azure Stack Hub.Use the same credentials that you used for deploying Azure Stack Hub. Skriptet fungerar inte om det konto som du använder med AzCredential kräver Multi-Factor Authentication (MFA).The script will fail if the account you use with AzCredential requires multi-factor authentication (MFA). ObligatorisktRequired
VMLocalCredentialVMLocalCredential Autentiseringsuppgifterna för det lokala administratörs kontot för den virtuella datorns SQL Resource Provider.The credentials for the local admin account of the SQL resource provider VM. ObligatorisktRequired
PrivilegedEndpointPrivilegedEndpoint IP-adressen eller DNS-namnet för den privilegierade slut punkten.The IP address or DNS name of the privileged endpoint. ObligatorisktRequired
AzureEnvironmentAzureEnvironment Azure-miljön för det tjänst administratörs konto som du använde för att distribuera Azure Stack Hub.The Azure environment of the service admin account which you used for deploying Azure Stack Hub. Krävs endast för Azure AD-distributioner.Required only for Azure AD deployments. Miljö namn som stöds är AzureCloud, azureusgovernment eller eller om du använder en Kina- AzureChinaCloud i Azure AD.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure AD, AzureChinaCloud. AzureCloudAzureCloud
DependencyFilesLocalPathDependencyFilesLocalPath Du måste också spara filen Certificate. pfx i den här katalogen.You must also put your certificate .pfx file in this directory. Valfritt för en enskild nod, men obligatoriskt för flera noderOptional for single node, but mandatory for multi-node
DefaultSSLCertificatePasswordDefaultSSLCertificatePassword Lösen ordet för PFX-certifikatet.The password for the .pfx certificate. ObligatorisktRequired
MaxRetryCountMaxRetryCount Antalet gånger som du vill försöka utföra varje åtgärd om det uppstår ett fel.The number of times you want to retry each operation if there's a failure. 22
RetryDurationRetryDuration Tids gräns intervallet mellan återförsök, i sekunder.The timeout interval between retries, in seconds. 120120
AvinstalleraUninstall Tar bort resurs leverantören och alla tillhör ande resurser.Removes the resource provider and all associated resources. NejNo
DebugModeDebugMode Förhindrar automatisk rensning vid haverining.Prevents automatic cleanup on failure. NejNo

Uppdatera skript PowerShell-exempelUpdate script PowerShell example

Om du uppdaterar SQL Resource Provider-versionen till 1.1.33.0 eller tidigare versioner måste du installera vissa versioner av AzureRm. start program och Azure Stack Hub-moduler i PowerShell.If you are updating the SQL resource provider version to 1.1.33.0 or previous versions, you need to install specific versions of AzureRm.BootStrapper and Azure Stack Hub modules in PowerShell.

Om du uppdaterar SQL-adressresursen till version 1.1.47.0 eller senare kan du hoppa över det här steget.If you are updating the SQL resource provider to version 1.1.47.0 or later, you can skip this step. Distributions skriptet laddar ned och installerar de nödvändiga PowerShell-modulerna automatiskt för sökvägen C:\Program Files\SqlMySqlPsh.The deployment script will automatically download and install the necessary PowerShell modules for you to path C:\Program Files\SqlMySqlPsh.

Anteckning

Om mappen C:\Program Files\SqlMySqlPsh redan finns med PowerShell-modulen, rekommenderar vi att du rensar den här mappen innan du kör uppdaterings skriptet.If folder C:\Program Files\SqlMySqlPsh already exists with PowerShell module downloaded, it is recommended to clean up this folder before running the update script. Detta görs för att se till att rätt version av PowerShell-modulen hämtas och används.This is to make sure the right version of PowerShell module is downloaded and used.

# Run the following scripts when updating to version 1.1.33.0 only.
# Install the AzureRM.Bootstrapper module, set the profile, and install the AzureStack module.
# Note that this might not be the most currently available version of Azure Stack Hub PowerShell.
Install-Module -Name AzureRm.BootStrapper -Force
Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.6.0

Anteckning

I frånkopplat scenario måste du hämta de PowerShell-moduler som krävs och registrera lagrings platsen manuellt som en förutsättning.In disconnected scenario, you need to download the required PowerShell modules and register the repository manually as a prerequisite. Du kan få mer information i Distribuera SQL Resource ProviderYou can get more information in Deploy SQL resource provider

Följande är ett exempel på hur du använder UpdateSQLProvider.ps1 -skriptet som du kan köra från en upphöjd PowerShell-konsol.The following is an example of using the UpdateSQLProvider.ps1 script that you can run from an elevated PowerShell console. Se till att ändra variabel information och lösen ord efter behov:Be sure to change the variable information and passwords as needed:

# Use the NetBIOS name for the Azure Stack Hub domain. On the Azure Stack Hub SDK, the default is AzureStack but this might have been changed at installation.
$domain = "AzureStack"

# For integrated systems, use the IP address of one of the ERCS VMs.
$privilegedEndpoint = "AzS-ERCS01"

# Provide the Azure environment used for deploying Azure Stack Hub. Required only for Azure AD deployments. Supported values for the <environment name> parameter are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
$AzureEnvironment = "<EnvironmentName>"

# Point to the directory where the resource provider installation files were extracted.
$tempDir = 'C:\TEMP\SQLRP'

# The service admin account (this can be Azure AD or AD FS).
$serviceAdmin = "admin@mydomain.onmicrosoft.com"
$AdminPass = ConvertTo-SecureString "P@ssw0rd1" -AsPlainText -Force
$AdminCreds = New-Object System.Management.Automation.PSCredential ($serviceAdmin, $AdminPass)

# Set the credentials for the new resource provider VM.
$vmLocalAdminPass = ConvertTo-SecureString "P@ssw0rd1" -AsPlainText -Force
$vmLocalAdminCreds = New-Object System.Management.Automation.PSCredential ("sqlrpadmin", $vmLocalAdminPass)

# Add the cloudadmin credential required for privileged endpoint access.
$CloudAdminPass = ConvertTo-SecureString "P@ssw0rd1" -AsPlainText -Force
$CloudAdminCreds = New-Object System.Management.Automation.PSCredential ("$domain\cloudadmin", $CloudAdminPass)

# Change the following as appropriate.
$PfxPass = ConvertTo-SecureString "P@ssw0rd1" -AsPlainText -Force

# For version 1.1.47.0 or later, the PowerShell modules used by the RP deployment are placed in C:\Program Files\SqlMySqlPsh
# The deployment script adds this path to the system $env:PSModulePath to ensure correct modules are used.
$rpModulePath = Join-Path -Path $env:ProgramFiles -ChildPath 'SqlMySqlPsh'
$env:PSModulePath = $env:PSModulePath + ";" + $rpModulePath

# Change directory to the folder where you extracted the installation files.
# Then adjust the endpoints.
. $tempDir\UpdateSQLProvider.ps1 -AzCredential $AdminCreds `
  -VMLocalCredential $vmLocalAdminCreds `
  -CloudAdminCredential $cloudAdminCreds `
  -PrivilegedEndpoint $privilegedEndpoint `
  -AzureEnvironment $AzureEnvironment `
  -DefaultSSLCertificatePassword $PfxPass `
  -DependencyFilesLocalPath $tempDir\cert

När uppdaterings skriptet för resurs leverantören har slutförts stänger du den aktuella PowerShell-sessionen.When the resource provider update script finishes, close the current PowerShell session.

Nästa stegNext steps

Underhålla SQL-resurs leverantörenMaintain the SQL resource provider