# Send Message

## PowerShell Script

The following is the Send Message sample PowerShell script. Copy it and save it as a **.ps1** file. For further information on hosting this script see [Quick Guide to Self-Hosting Custom Scripts](/faronicsdeploy/custom-scripts-powershell-vb-batch/custom-scripts-library/quick-guide-to-self-hosting-custom-scripts.md). 

```
msg.exe * $args[0]
```

## Custom Script Settings

The table below outlines all the fields that need to be set when creating this custom script. 

{% hint style="info" %}
For a detailed guide, refer to [Create a Send Message Custom Script](/faronicsdeploy/custom-scripts-powershell-vb-batch/custom-scripts-library/custom-script-example-send-message.md#create-a-send-message-custom-script).
{% endhint %}

| Field        | Value                                                                                                                   |
| ------------ | ----------------------------------------------------------------------------------------------------------------------- |
| Name         | **Send Message**                                                                                                        |
| URL          | <http://www.faronics.org/SendMessage.ps1>                                                                               |
| Type         | **PowerShell**                                                                                                          |
| Command-Line | Enter a message to display to the computer that it is being run on, e.g., **"This computer will reboot in 5 minutes."** |
| Run As       | **System Account** or **Specified User Account**                                                                        |

###

## Create a Send Message Custom Script

![Create a Custom Script](/files/-MVTMQo7yXAzeNjC65UE)

1\. Select the **Control Grid** tab on the top menu bar.

2\. Navigate to the **Applications** tab.

3\. Click **CUSTOM** **SCRIPT**.

4\. Select **Create** **Custom** **Script**.

5\. Enter a **Name** for the script, **Send Message** in this example, use any name you'd like to use.

![Creating a Custom Script](/files/-MWyrMiG7a1M7A1Hd9R7)

6\. Enter the **URL** that points to the location where the script is being hosted,  <http://www.faronics.org/SendMessage.ps1> in this example. You might need to download this file and host it on a link that is whitelisted in your firewall.

{% hint style="info" %}
Best Practice is to download the sample script and self-host it. You can do this for free with GitHub. See the [Quick Guide to Self-Hosting Custom Scripts](/faronicsdeploy/custom-scripts-powershell-vb-batch/custom-scripts-library/quick-guide-to-self-hosting-custom-scripts.md) for more information.
{% endhint %}

7\. Select the script type: **Powershell**.

8\. **Command Line**: Enter the message you’d like to send to the workstations enclosed in double-quotes, "**This computer will reboot in 5 minutes"** in this example.

9\. Select the account to **Run As**; either **System Accoun**t or **Specified User Account**.

10\. Click **SAVE TO GRID**.

{% hint style="info" %}
Once saved, the script can be pushed to an individual computer or groups of computers. It can also be scheduled using a Policy.

For a guide on how to run your Custom Script, see [Pushing the Script](/faronicsdeploy/custom-scripts-powershell-vb-batch.md#pushing-the-script).
{% endhint %}

{% hint style="success" %}
The script will now appear in the list of Custom Scripts. It will also be available to select from the Applications Control Grid View.&#x20;

Search for the script in the grid using the search option. If your applications are grouped, you will see a column named **Custom** **Scripts**. Selecting the **Custom Script header** will display all the scripts that have been added to the grid.&#x20;
{% endhint %}

When the Send Message custom script is run, it will appear as a pop-up, as shown in the screenshot below:

![Message That Appears When Running the Custom Script](/files/-MWyrfJIfPHFSYHcBqVu)


---

# 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.faronics.com/faronicsdeploy/custom-scripts-powershell-vb-batch/custom-scripts-library/custom-script-example-send-message.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.