ps>Get-Help BuildTearDown -Full

NAME
    BuildTearDown

SYNOPSIS
    Adds a scriptblock that will be executed once at the end of the build


SYNTAX
    BuildTearDown [-Setup] <ScriptBlock> [<CommonParameters>]


DESCRIPTION
    This function will accept a scriptblock that will be executed once at the end of the
    build, regardless of success or failure


PARAMETERS
    -Setup <ScriptBlock>
        A scriptblock to execute

        Required?                    true
        Position?                    1
        Default value
        Accept pipeline input?       false
        Accept wildcard characters?  false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, see
        about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

    -------------------------- EXAMPLE 1 --------------------------

    PS C:\>A sample build script is shown below:

    Task default -Depends Test
    Task Test -Depends Compile, Clean {
    }
    Task Compile -Depends Clean {
    }
    Task Clean {
    }
    BuildTearDown {
        "Running 'BuildTearDown'"
    }
    The script above produces the following output:
    Executing task, Clean...
    Executing task, Compile...
    Executing task, Test...
    Running 'BuildTearDown'
    Build Succeeded




    -------------------------- EXAMPLE 2 --------------------------

    PS C:\>A failing build script is shown below:

    Task default -Depends Test
    Task Test -Depends Compile, Clean {
        throw "forced error"
    }
    Task Compile -Depends Clean {
    }
    Task Clean {
    }
    BuildTearDown {
        "Running 'BuildTearDown'"
    }
    The script above produces the following output:
    Executing task, Clean...
    Executing task, Compile...
    Executing task, Test...
    Running 'BuildTearDown'
    forced error
    At line:x char:x ...





RELATED LINKS
    Assert
    Exec
    FormatTaskName
    Framework
    Invoke-psake
    Properties
    Task
    BuildSetup
    TaskSetup
    TaskTearDown