# Show-BTNotification

## SYNOPSIS

Shows a new toast notification.

## SYNTAX

```powershell
Show-BTNotification [-ContentBuilder] <ToastContentBuilder[]> [-WhatIf] [-Confirm] [<CommonParameters>]
```

## DESCRIPTION

The Show-BTNotification function shows a new toast notification with its configured content.

## EXAMPLES

### EXAMPLE 1

```powershell
Show-BTNotification -ContentBuilder $ToastContentBuilder
```

This command displays a toast notification with the content of the ToastContentBuilder object.

### EXAMPLE 2

```powershell
$ToastContentBuilder | Show-BTNotification
```

This command displays a toast notification with the content of the ToastContentBuilder object supplied via the pipeline.

### EXAMPLE 3

```powershell
$Builder = New-BTContentBuilder
$Builder | Add-BTText -Text 'First Line of Text', 'Second Line of Text'
Show-BTNotification -ContentBuilder $Builder
```

This example demonstrates the full life cycle of a ToastContentBuilder object from creation to display.

## PARAMETERS

### -ContentBuilder

{{ Fill ContentBuilder Description }}

```yaml
Type: ToastContentBuilder[]
Parameter Sets: (All)
Aliases:

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

### -WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Confirm

Prompts you for confirmation before running the cmdlet.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

### Microsoft.Toolkit.Uwp.Notifications.ToastContentBuilder

You can pipe a toast content builder object to Show-BTNotification.

## OUTPUTS

### None

## NOTES

## RELATED LINKS


---

# 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.toastit.dev/commands/show-btnotification.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.