# Protocol Handlers

![Protocol Handlers in the Admin Console](https://427210397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZsd6kaluvxbsdXs9MWxX%2Fuploads%2FnkSQe2Sjr3x7HAQ3oyfa%2Fimage.png?alt=media\&token=6dfa3491-7748-4080-8a21-35b9da060f9a)

Protocol handlers allow you to trigger scripts when custom protocols are executed. Protocols can be executed locally and also from webpages as links. 

## Define a Protocol Handle

You can define protocol handlers in the `protocolHandlers.ps1` file using the `New-PSUProtocolHandler` cmdlet. You will need to define the protocol name and script to execute. 

```powershell
New-PSUProtocolHandler -Script test.ps1 -Protocol psu
```

To execute the protocol handler, you could include the following HTML tag in a web page. 

```powershell
<a href="psu://test">Click Me</a>
```

## Accessing URI Data

When a script is executed, you will receive the `$ProtocolUri` parameter. It will include the full URI that was invoked. For example, a script could take the URI and show a page.&#x20;

```powershell
param($ProtocolUri)

$Page = $ProtocolUri.Replace("psu://", "")
$Page
Show-PSUPage -Url $Page
```