运行升级顾问(命令提示符)

使用 UpgradeAdvisorWizardCmd 实用工具从命令提示符运行升级顾问。 可以选择以 XML 格式或以逗号分隔值文件来接收结果。

语法

  
      UpgradeAdvisorWizardCmd [ -? ]  |   
    [ -ConfigFilefilename | <server_info> ]  
    [ -SqlUserlogin_id-SqlPasswordpassword ]  
    [ -CSV ]  
  
where <server_info> is any combination of the following:  
        -Serverserver_name-Instanceinstance_name-ASInstanceAS_instance_name-RSInstanceRS_instance_name  

参数

-?
显示命令的语法。

-ConfigFilefilename
XML 文件的路径名称和文件名,其中包含在运行 UpgradeAdvisorWizardCmd 实用工具时要使用的设置。

<server_info>
指定要分析的计算机和实例。 如果不使用配置文件,则使用这些选项。

<>server_info可以是以下四个参数的任意组合:

-Serverserver_name
指定要分析的计算机的名称。 这可以是本地计算机(默认值)或远程计算机。

-实例instance_name
指定要分析的实例的名称。 没有默认值。 如果未指定此参数,则不会扫描数据库引擎。 SQL Server 的默认实例的值为 MSSQLSERVER。 对于命名实例,使用实例名称。

-ASInstanceAS_instance_name
指定要分析的 Analysis Services 实例的名称。 没有默认值。 如果未指定此值,则不会扫描 Analysis Services。 Analysis Services 的默认实例的值为 MSSQLServerOLAPService。 对于命名实例,使用实例名称。

-RSInstanceRS_instance_name
指定要分析的Reporting Services实例的名称。 没有默认值。 如果未指定此值,则不会扫描Reporting Services。 Reporting Services的默认实例的值为 ReportServer。 对于命名实例,使用实例名称。

-SqlUserlogin_id
如果使用SQL Server身份验证,则此值是升级顾问用于连接到 SQL Server 实例的SQL Server登录名。 如果未指定登录名,则使用 Windows 身份验证连接到 SQL Server 实例。

-SqlPassword密码
如果使用 -SqlUser 参数,请使用此参数指定SQL Server登录名的密码。

-Csv
指定除了标准 XML 结果外还将结果以逗号分隔值写入到 .csv 文件中。 结果将写入 My Documents\SQL Server Upgrade Advisor\110\Reports 文件夹。

返回值

下表显示了 UpgradeAdvisorWizardCmd 返回的值。

说明
0 成功完成分析,找不到任何升级问题。
正整数 成功完成分析,找到升级问题。
负整数 分析失败。

备注

除SQL Server身份验证用户名和密码外,运行分析所需的所有信息都可以在 XML 配置文件中提供。 此 XML 配置文件记录在模板中。 如果不使用配置文件,则可以使用默认设置通过指定计算机名称和实例名称来分析 SQL Server 实例中的所有已安装组件。 有关默认配置文件设置的说明,请参阅本主题后面的“元素说明”表。

配置文件模板

可使用以下 XML 作为模板来创建自己的配置文件。 您可以修改模板,以满足组织的需要。

<Configuration>  
    <Server> </Server>  
    <Instance></Instance>  
    <Components>  
        <SQLServer>  
            <Databases>  
                <Database></Database>  
            </Databases>  
            <TraceFiles>  
                <TraceFile></TraceFile>  
            </TraceFiles>  
            <BatchFiles>  
                <BatchFile></BatchFile>  
            </BatchFiles>  
            <BatchSeparator></BatchSeparator>  
        </SQLServer>  
        <AnalysisServices>  
            <ASInstance></ASInstance>  
            <Databases>  
                <Database></Database>  
            </Databases>  
        </AnalysisServices>  
        <ReportingServices>  
            <RSInstance></RSInstance>  
        </ReportingServices>  
        <IntegrationServices>  
            <PackagePath></PackagePath>  
        </IntegrationServices>  
    </Components>  
</Configuration>  

元素说明

标记 定义 出现次数
Configuration 升级顾问配置文件的父元素。 每个配置文件必须出现一次。
Server 要分析的服务器的名称。 每个配置文件可以出现一次。 默认值为本地计算机。
Instance 要分析的数据库引擎实例的名称。 每个配置文件可以出现一次。 默认值为默认实例。

如果服务器上存在SQL Server元素或元素,则每个配置文件需要一IntegrationServices次。
Components 包含指定要分析的组件的元素。 每个配置文件必须出现一次。
SQLServer 包含数据库引擎实例的分析设置。 每个配置文件可以出现一次。 如果未指定,则不分析数据库引擎数据库。
Databases 元素的 SQLServer 包含要分析的数据库的列表。 每个元素可选 SQLServer 一次。 如果此元素不存在,则分析实例中的所有数据库。
Database 元素的 SQLServer 指定要分析的数据库的名称。 如果 Databases 元素存在,则必须出现一次或多次。 如果 Database 元素包含值“*”,则分析实例中的所有数据库。 没有默认值。
TraceFiles 包含要分析的跟踪文件的列表。 每个元素可选 SQLServer 一次。
TraceFile 指定要分析的跟踪文件的路径和名称。 如果 TraceFiles 元素存在,则必须出现一次或多次。 没有默认值。
BatchFiles 包含要分析的批处理文件的列表。 每个元素可选 SQLServer 一次。
BatchFile 指定要分析的批处理文件。 可以是多个文件。 如果 BatchFiles 元素存在,则必须出现一次或多次。 没有默认值。
BatchSeparator 指定SQL Server批处理文件中使用的批处理分隔符。 每个元素可选 SQLServer 一次。 默认值为 GO。
AnalysisServices 包含 Analysis Services 的分析设置。 每个配置文件可以出现一次。 如果未指定,则不分析 Analysis Services 数据库。
ASInstance 指定 Analysis Services 实例的名称。 每个 AnalysisServices 元素必须出现一次。 没有默认值。
Databases 元素的 Analysis Services 包含要分析的数据库的列表。 每个元素可选 AnalysisServices 一次。 如果此元素不存在,则分析实例中的所有数据库。
Database 元素的 AnalysisServices 指定要分析的数据库的名称。 如果 Databases 元素存在,则必须出现一次或多次。 如果 Database 元素包含值“*”,则分析实例中的所有数据库。 没有默认值。
ReportingServices 指定针对Reporting Services运行分析。 每个配置文件可以出现一次。 如果未指定,则不分析Reporting Services。
RSInstance 指定 Reporting Services 实例的名称。 每个 ReportingServices 元素必须出现一次。 没有默认值。
IntegrationServices 包含 SQL Server Integration Services 的分析设置。 每个配置文件可以出现一次。 如果未指定,则不分析 Integration Services。
PackagePath 指定一组 Integration Services 包的路径。 每个元素可选 IntegrationServices 一次。 如果不存在此元素,则分析SQL Server实例,并且不会分析外部存储的包。 没有默认值。

示例

A. 使用配置文件运行升级顾问

下面的示例演示如何通过使用指定分析内容的配置文件从命令提示符运行升级顾问。 此示例使用 Windows 身份验证连接到 SQL Server。

UpgradeAdvisorWizardCmd -ConfigFile "C:\My Documents\UpgradeConfig1.xml"  

B. 使用默认配置设置运行升级顾问

下面的示例演示如何通过使用默认配置设置和 Windows 身份验证从命令提示符运行升级顾问。

UpgradeAdvisorWizardCmd -Server MyServer -Instance MyInst   

C. 使用SQL Server身份验证运行升级顾问

下面的示例演示如何通过使用配置文件从命令提示符运行升级顾问。 此示例指定用于连接到 SQL Server 实例的SQL Server用户名和密码。

UpgradeAdvisorWizardCmd -ConfigFile "C:\My Documents\UpgradeConfig1.xml"   
    -SqlUser "MyUserName" -SqlPassword "QweRTy-55"  

另请参阅

解决升级问题
使用升级顾问
运行升级顾问(用户界面)