Repair‑SqlDscBIReportServer

SYNOPSIS

Repairs an existing SQL Server Power BI Report Server installation.

SYNTAX

Repair-SqlDscBIReportServer [-AcceptLicensingTerms] [-MediaPath] <String> [[-ProductKey] <String>]
 [-EditionUpgrade] [[-Edition] <String>] [[-LogPath] <String>] [[-InstallFolder] <String>] [-SuppressRestart]
 [[-Timeout] <UInt32>] [-Force] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Repairs an existing SQL Server Power BI Report Server installation using the provided setup executable.

EXAMPLES

EXAMPLE 1

Repair-SqlDscBIReportServer -AcceptLicensingTerms -MediaPath 'E:\PowerBIReportServer.exe'

Repairs Power BI Report Server with default settings.

EXAMPLE 2

Repair-SqlDscBIReportServer -AcceptLicensingTerms -MediaPath 'E:\PowerBIReportServer.exe' -ProductKey '12345-12345-12345-12345-12345' -EditionUpgrade

Repairs Power BI Report Server and upgrades the edition using a product key.

EXAMPLE 3

Repair-SqlDscBIReportServer -AcceptLicensingTerms -MediaPath 'E:\PowerBIReportServer.exe' -LogPath 'C:\Logs\PowerBIReportServer_Repair.log'

Repairs Power BI Report Server and specifies a custom log path.

EXAMPLE 4

$exitCode = Repair-SqlDscBIReportServer -AcceptLicensingTerms -MediaPath 'E:\PowerBIReportServer.exe' -PassThru

Repairs Power BI Report Server with default settings and returns the setup exit code.

PARAMETERS

-AcceptLicensingTerms

Required parameter to be able to run unattended repair. By specifying this parameter you acknowledge the acceptance of all license terms and notices for the specified features, the terms and notices that the setup executable normally asks for.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Edition

Specifies a free custom edition to use for the repair. This parameter is mutually exclusive with the parameter ProductKey.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EditionUpgrade

Upgrades the edition of the installed product. Requires that either the ProductKey or the Edition parameter is also assigned. By default no edition upgrade is performed.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Force

If specified the command will not ask for confirmation. Same as if Confirm:$false is used.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-InstallFolder

Specifies the folder where to install the product, e.g. 'C:\Program Files\Power BI Report Server'. By default the product is installed under the default installation folder.

PI Report Server: %ProgramFiles%\Microsoft Power BI Report Server

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LogPath

Specifies the file path where to write the log files, e.g. 'C:\Logs\Repair.log'. By default log files are created under %TEMP%.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MediaPath

Specifies the path where to find the SQL Server installation media. On this path the SQL Server setup executable must be found.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

If specified the command will return the setup process exit code.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ProductKey

Specifies the product key to use for the repair, e.g. '12345-12345-12345-12345-12345'. This parameter is mutually exclusive with the parameter Edition.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuppressRestart

Suppresses the restart of the computer after the repair is finished. By default the computer is restarted after the repair is finished.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Timeout

Specifies how long to wait for the setup process to finish. Default value is 7200 seconds (2 hours). If the setup process does not finish before this time, an exception will be thrown.

Type: UInt32
Parameter Sets: (All)
Aliases:

Required: False
Position: 6
Default value: 7200
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

When PassThru is specified the function will return the setup process exit

code as System.Int32. Otherwise, the function does not generate any output.

NOTES

RELATED LINKS