external help file | Module Name | online version | schema |
---|---|---|---|
Bicep-help.xml |
Bicep |
2.0.0 |
Create markdown documentation for bicep files
New-BicepMarkdownDocumentation [[-File] <String>] [-AsString] [-Force]
[<CommonParameters>]
New-BicepMarkdownDocumentation [[-Path] <String>] [-Recurse] [-AsString] [-Force]
[<CommonParameters>]
This command creates a basic markdown documentation of one or more bicep files.
PS C:\> New-BicepMarkdownDocumentation -File C:\MyBicepFile.bicep
This command will create a file called c:\MyBicepFile.md
containing basic documentation.
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.
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
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
NOT IMPLEMENTED!
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
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
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
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.