# $cs.Log_SectionHeader

> Writes a decorative bordered section-header block into the log, to visually separate a group of related log entries.

Source: https://docs.capaone.com/capainstaller/powerpacks/cs-log-sectionheader/  
Product: CapaInstaller — a separate CapaSystems product; do not apply this page to any other.

### Description

Writes a decorative bordered section-header block into the log, to visually separate a group of related log entries. This is called at the top of every function in the PowerPack script template.

### Syntax

$cs.Log_SectionHeader(string name, char framecharacter = 'o')

### Parameters

#### name (String)

Name to display in the section header.

#### framecharacter (Char)

Character used to build the border around the section header. Defaults to `'o'`.

### Return value

None

### Example

**PowerShell**

```powershell
function Install {
  $cs.Log_SectionHeader('Install', 'o')
  $cs.Job_WriteLog("Starting installation of $global:AppName $global:AppRelease")
}
```

Result in the log:

**Text**

```text
2022-03-16 13:38:19 - oooooooooooooooooooooooooooooooooooooooooooooooooooooo
2022-03-16 13:38:19 - o                     Install                        o
2022-03-16 13:38:19 - oooooooooooooooooooooooooooooooooooooooooooooooooooooo
```

The same pattern is used at the top of every template function, for example `PreInstall` and `PostInstall`, so the log clearly shows where each phase begins:

```powershell
function PreInstall {
  $cs.Log_SectionHeader('PreInstall', 'o')
  $cs.Job_WriteLog("Checking prerequisites for $global:AppName $global:AppRelease")
}

function PostInstall {
  $cs.Log_SectionHeader('PostInstall', 'o')
  $cs.Job_WriteLog("Running post-install cleanup for $global:AppName $global:AppRelease")
}
```

### Related functions

[$cs.Job_WriteLog](/capainstaller/powerpacks/cs-job-writelog/)