# About the Universal Portal

The PowerShell Universal Portal provides a single location your end users can go to access resources and services you have developed in PowerShell Universal. The following resources will be shown the portal when they are assigned to a user's role.

* API Documentation
* Scripts
* Portal Pages
* Apps

When a user visits the portal, they will be shown a searchable list of the resources you have assigned.

<figure><img src="https://1373299915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8F6PrkNTG8Y34hADzKOL%2Fuploads%2Fgit-blob-a5ebdfb28d5edb638b4a1cd3bb0e328b38506b4e%2Fimage.png?alt=media" alt=""><figcaption><p>Service Page</p></figcaption></figure>

Clicking Open on API Documentation, Blazor Apps or PowerShell Apps will open the linked resource. Clicking Open on a Script will display the rendered script markdown documentation and allow the user to enter any parameters.

<figure><img src="https://1373299915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8F6PrkNTG8Y34hADzKOL%2Fuploads%2Fgit-blob-24dc14e7cbcd1f8eaec2213ace8bd7cc08ad578d%2Fimage.png?alt=media" alt=""><figcaption><p>Script Page</p></figcaption></figure>

You can choose how the script is displayed after it is run. By default, it will simply display a success of failure message. You can also choose to display the output text from the script.

<figure><img src="https://1373299915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8F6PrkNTG8Y34hADzKOL%2Fuploads%2Fgit-blob-6dc831f9ffc105b6be9a02708f69182b699e5ea2%2Fimage.png?alt=media" alt=""><figcaption><p>Script Output</p></figcaption></figure>

A history page is also provided to allow the users to see a record of the scripts that were run.

<figure><img src="https://1373299915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8F6PrkNTG8Y34hADzKOL%2Fuploads%2Fgit-blob-dc46317879189e442590a1c675afc0a3019e1174%2Fimage.png?alt=media" alt=""><figcaption><p>History Page</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powershelluniversal.com/portal/portal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
