[Write-RsRestCatalogItem] add `Hidden` parameter

[zsvr-pkruse]

Fixes absence of Hidden parameter for Write-RsRestCatalogItem

Changes proposed in this pull request:

• add Hidden parameter to Write-RsRestCatalogItem
• update documentation
• clean up Overwrite upload section

How to test this code:

• Write-RsRestCatalogItem -WebSession $session -Path 'your_path_here' -RsFolder 'target_path_here' -Hidden
• See your selected item on report server marked as Hidden

Has been tested on (remove any that don't apply):

• Powershell 3 and above
• Windows 7 and above
• SQL Server 2012 and above

---

Details

The following can now be uploaded as hidden:

• DataSource
• Kpi
• all others except large power bi report files (>=MinLargeFileSizeInMb)

Clarify documentation of

• Description
• Overwrite

to be ignored by large Power BI Report files.

Add documentation for new Hidden parameter. Add example for new Hidden parameter. Fix some formatting issues. Add information about ignored parameters to verbose write. Remove ignored fields from large file upload. See https://app.swaggerhub.com/apis-docs/microsoft-rs/pbirs/2.0#/PowerBIReports/UploadPowerBIReport Make Try upload block smaller. The follow-up catch block was still relying on parts of the now moved out code block. Overwrite upload code now uses same $requestBody as normal upload. Kpi Hidden property is only changed if parameter Hidden is used.

Automated tests weren't extended because Description paramater isn't tested either.

Please let me know how to improve this Pull Request.

[zsvr-pkruse]

@microsoft-github-policy-service agree [company="Stiftung Zentrale Stelle Verpackungsregister"]

[zsvr-pkruse]

@microsoft-github-policy-service agree company="Stiftung Zentrale Stelle Verpackungsregister"

[zsvr-pkruse]

Build failed because an external server is not available during testing? I'm not sure how to proceed here.

VERBOSE: POST http://localhost/reports/api/v1.0/ReportServerInfo/Model.UpdateSettings with -1-byte payload
System.Net.WebException: The remote server returned an error: (503) Server Unavailable.
   at Microsoft.PowerShell.Commands.WebRequestPSCmdlet.GetResponse(WebRequest request)
   at Microsoft.PowerShell.Commands.WebRequestPSCmdlet.ProcessRecord()