Update-MarkdownHelpModule

Referentie

Module:: platyPS

Werk alle bestanden in een markdown Help-modulemap bij.

Syntaxis

Update-MarkdownHelpModule
      [-Path] <String[]>
      [[-Encoding] <Encoding>]
      [-RefreshModulePage]
      [-ModulePagePath <String>]
      [[-LogPath] <String>]
      [-LogAppend]
      [-AlphabeticParamsOrder]
      [-UseFullTypeName]
      [-UpdateInputOutput]
      [-Force]
      [-Session <PSSession>]
      [-ExcludeDontShow]
      [<CommonParameters>]

Description

De Update-MarkdownHelpModule cmdlet werkt bestaande Help Markdown-bestanden bij en maakt markdown-bestanden voor nieuwe cmdlets in een module. Deze cmdlet combineert functionaliteit van de Update-MarkdownHelp- en Cmdlets New-MarkdownHelp om een bulkupdate uit te voeren.

Voorbeelden

Voorbeeld 1: Een Markdown Help-module bijwerken

PS C:\> Update-MarkdownHelpModule -Path ".\docs"

    Directory: D:\Working\PlatyPS\docs


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        5/22/2016   6:54 PM           1496 Get-HelpPreview.md
-a----        5/22/2016   6:54 PM           3208 Get-MarkdownMetadata.md
-a----        5/22/2016   6:54 PM           3059 New-ExternalHelp.md
-a----        5/22/2016   6:54 PM           2702 New-ExternalHelpCab.md
-a----        5/22/2016   6:54 PM           6234 New-MarkdownHelp.md
-a----        5/22/2016   6:54 PM           2346 Update-MarkdownHelp.md
-a----        5/22/2016   6:54 PM           1633 Update-MarkdownHelpModule.md
-a----        5/22/2016   6:54 PM           1630 Update-MarkdownHelpSchema.md

Met deze opdracht worden alle bestanden in de opgegeven map bijgewerkt op basis van de cmdlets die in uw huidige sessie zijn geladen. Met de opdracht maakt u markdown Help-onderwerpen voor cmdlets die nog niet zijn opgenomen in de map .\docs.

Parameters

-AlphabeticParamsOrder

Volgordeparameters alfabetisch op naam in de sectie PARAMETERS. Er zijn vijf uitzonderingen: -Confirm, -WhatIf, -IncludeTotalCount, -Skipen -First parameters zijn de laatste. Deze parameters zijn gebruikelijk en hebben daarom goed gedefinieerd gedrag.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Encoding

Hiermee geeft u de tekencodering voor uw externe Help-bestand. Geef een System.Text.Encoding--object op. Zie about_Character_Encodingvoor meer informatie.

Type:	Encoding
Position:	1
Default value:	UTF8 without BOM
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ExcludeDontShow

Sluit de parameters uit die zijn gemarkeerd met DontShow in het parameterkenmerk van de Help-inhoud.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Force

Help-bestanden verwijderen die niet meer bestaan binnen sessies (bijvoorbeeld als de functie is verwijderd).

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LogAppend

Geeft aan dat deze cmdlet informatie toevoegt aan het logboek in plaats daarvan overschrijft.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LogPath

Hiermee geeft u een bestandspad voor logboekgegevens. De cmdlet schrijft de UITGEBREIDE stream naar het logboek. Als u de parameter Uitgebreide opgeeft, schrijft deze cmdlet die informatie ook naar de console.

Type:	String
Position:	2
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ModulePagePath

Wanneer -RefreshModulePage standaard wordt gebruikt, plaatst het MD-bestand op dezelfde locatie als alle andere documenten. Met deze parameter kunt u een nieuwe naam/locatie opgeven die betere plaatsingsopties biedt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Path

Hiermee geeft u een matrix van paden van Markdown-mappen die moeten worden bijgewerkt. De map moet een modulepagina bevatten waaruit deze cmdlet de naam van de module kan ophalen.

Type:	String[]
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	True

-RefreshModulePage

De modulepagina bijwerken bij het bijwerken van de Help-module.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Session

Biedt ondersteuning voor externe opdrachten. Geef de sessie door die u hebt gebruikt om de opdrachten te maken met Import-PSSession. Dit is vereist om nauwkeurige parametersmetagegevens van de externe sessie op te halen.

Type:	PSSession
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UpdateInputOutput

Hiermee worden de secties Invoer en Uitvoer vernieuwd om de huidige status van de cmdlet weer te geven. WAARSCHUWING: met deze parameter worden alle handmatige toevoegingen aan deze secties verwijderd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UseFullTypeName

Geeft aan dat het doeldocument een volledige typenaam gebruikt in plaats van een korte naam voor parameters.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String[]

U kunt een matrix met paden naar deze cmdlet doorsluisen.

Uitvoerwaarden

FileInfo[]

Met deze cmdlet wordt een FileInfo[]-object geretourneerd voor bijgewerkte en nieuwe bestanden.

Notities

De module waarvoor u de Help wilt bijwerken, moet eerst worden geïmporteerd vanaf de locatie met de vorige versie van de Help. Als niet aan deze voorwaarde wordt voldaan, wordt de parametervolgorde alfabetisch weergegeven in de bijgewerkte Help, zelfs als de parameter AlphabeticParamsOrder niet is gebruikt.

Delen via