# Card

**Cards contain content and actions about a single subject.**

Cards are surfaces that display content and actions on a single topic. They should be easy to scan for relevant and actionable information. Elements, like text and images, should be placed on them in a way that clearly indicates hierarchy.

## Simple Card

Although cards can support multiple actions, UI controls, and an overflow menu, use restraint and remember that cards are entry points to more complex and detailed information.

![](/files/-MAgJdBoNLrud__hRtlB)

```
New-UDCard -Title 'Simple Card' -Content {
    "This is some content"
}
```

## Advanced Card

You can use the body, header, footer and expand cmdlets to create advanced cards. The below example creates a card with various features based on a Hyper-V VM.

```
$VM = Get-VM -Name $VMName @ConnectionInfo

$Header = New-UDCardHeader -Title $VM.Name

$Footer = New-UDCardFooter -Content {
    if ($VM.State -eq 'Running')
    {
        New-UDButton -Variant text -Text 'Stop' -OnClick {
            Show-UDToast -Message 'Stopping VM...' -Duration 5000
            Stop-VM -VMName $VM.name @ConnectionInfo 
            Sync-UDElement -Id "$($VMName)_card"
        }
    } else {
        New-UDButton -Variant text -Text 'Start' -OnClick {
            Show-UDToast -Message 'Starting VM...' -Duration 5000
            Start-VM -VMName $VM.name @ConnectionInfo 
            Sync-UDElement -Id "$($VMName)_card"
        }
    }

}

$Body = New-UDCardBody -Content {
    New-UDTable -Data ($VM | Select-Object Name, State, CPUUsage, MemoryAssigned, Uptime)  -Dense 
}

$Expand = New-UDCardExpand -Content {
    New-UDElement -Tag 'div' -Content {
        New-UDTable -Data ($VM.DvdDrives | Select-Object Name, DvdMediaType, Path) -Title 'DVD Drives' -Dense
    } 

    $Drives = Get-VMHardDiskDrive -VMName $VM.Name @ConnectionInfo | Select-Object Name, Path
    New-UDTable -Data $Drives -Title 'Hard Disk Drives' -Dense

    New-UDTable -Data ($VM.NetworkAdapters | Select-Object 'SwitchName', 'MacAddress' ) -Dense -Title 'Network Adapters' 
}

New-UDStyle -Style '.ud-mu-cardexpand { display: block !important }' -Content {
    New-UDCard -Body $Body -Header $Header -Footer $Footer -Expand $Expand
}
```

![Expandable Card](/files/-MVJ5N5XrKjUBuKiFe-R)

**New-UDCard**

| Name           | Type            | Description                                                                                                                                  | Required |
| -------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| Id             | String          | The ID of the component. It defaults to a random GUID.                                                                                       | false    |
| ClassName      | String          | A CSS class to assign to this card.                                                                                                          | false    |
| ShowToolBar    | SwitchParameter | Whether to show the toolbar for this card.                                                                                                   | false    |
| ToolBar        | Object          | The toolbar for this card. Use New-UDCardToolbar to create a toolbar.                                                                        | false    |
| Header         | Object          | The header for this card. The header typically contains a title for the card. Use New-UDCardHeader to create a header.                       | false    |
| Body           | Object          | The body for this card. This is the main content for the card. Use New-UDCardHeader to create a body.                                        | false    |
| Expand         | Object          | Th expand content for this card. Expand content is show when the user clicks the expansion button. Use New-UDCardExpand to create an expand. | false    |
| Footer         | Object          | The footer for this card. Footer contents typically contain actions that are relavent to the card. Use New-UDCardFooter to create a footer.  | false    |
| Style          | Hashtable       | Styles to apply to the card.                                                                                                                 | false    |
| Elevation      | Int32           | The amount of elevation to provide the card. The more elevation, the more it will appear the card is floating off the page.                  | false    |
| Title          | String          | A title for the card.                                                                                                                        | false    |
| TitleAlignment | String          | The alignment for the title.                                                                                                                 | false    |
| Content        | ScriptBlock     | The content of the card.                                                                                                                     | false    |
| Image          | String          | An image to show in the card.                                                                                                                | false    |


---

# 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/v1/dashboard/components/surfaces/card.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.