Skip to content

Latest commit

 

History

History
136 lines (102 loc) · 2.68 KB

New-BicepMarkdownDocumentation.md

File metadata and controls

136 lines (102 loc) · 2.68 KB
external help file Module Name online version schema
Bicep-help.xml
Bicep
2.0.0

New-BicepMarkdownDocumentation

SYNOPSIS

Create markdown documentation for bicep files

SYNTAX

FromFile (Default)

New-BicepMarkdownDocumentation [[-File] <String>] [-AsString] [-Force]
[<CommonParameters>]

FromFolder

New-BicepMarkdownDocumentation [[-Path] <String>] [-Recurse] [-AsString] [-Force]
[<CommonParameters>]

DESCRIPTION

This command creates a basic markdown documentation of one or more bicep files.

EXAMPLES

Example 1

PS C:\> New-BicepMarkdownDocumentation -File C:\MyBicepFile.bicep

This command will create a file called c:\MyBicepFile.md containing basic documentation.

Example 2

PS C:\> New-BicepMarkdownDocumentation -Path C:\MyBicepFiles\ -Verbose -Recurse

This command will traverse the c:\MyBicepFiles\ folder, including subfolders, and create documentation for all bicep files. The markdown files will be saved with the same name as the bicep files, using .md file extension.

PARAMETERS

-AsString

Output the resulting markdown to to the cosole as string.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-File

Bicep file to create documentation from

Type: String
Parameter Sets: FromFile
Aliases:

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

-Force

NOT IMPLEMENTED!

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Path to folder containing bicep files. All files in folder will have markdown documentation created.

Type: String
Parameter Sets: FromFolder
Aliases:

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

-Recurse

Search recursively for .bicep files.

Type: SwitchParameter
Parameter Sets: FromFolder
Aliases:

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, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

File or string

NOTES

RELATED LINKS