Get‑SqlDscRSUrlReservation - dsccommunity/SqlServerDsc GitHub Wiki

Gets the URL reservations for SQL Server Reporting Services.

Get-SqlDscRSUrlReservation [-Configuration] <Object> [<CommonParameters>]

Gets the URL reservations for SQL Server Reporting Services or Power BI Report Server by calling the ListReservedUrls method on the MSReportServer_ConfigurationSetting CIM instance.

The configuration CIM instance can be obtained using the Get-SqlDscRSConfiguration command and passed via the pipeline.

Get-SqlDscRSConfiguration -InstanceName 'SSRS' | Get-SqlDscRSUrlReservation

Gets all URL reservations for the SSRS instance.

$config = Get-SqlDscRSConfiguration -InstanceName 'SSRS'
Get-SqlDscRSUrlReservation -Configuration $config

Gets all URL reservations for the SSRS instance by passing the configuration as a parameter.

Specifies the MSReportServer_ConfigurationSetting CIM instance for the Reporting Services instance. This can be obtained using the Get-SqlDscRSConfiguration command. This parameter accepts pipeline input.

Type: Object
Parameter Sets: (All)
Aliases:

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

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

The returned object contains two arrays:

• Application: Array of application names (e.g., 'ReportServerWebService', 'ReportServerWebApp', 'ReportManager')
• UrlString: Array of URL strings (e.g., 'http://+:80')

The arrays are correlated by index, so Application[0] corresponds to UrlString[0].