Udostępnij za pośrednictwem

New-ExternalHelp

  • Odwołanie
Moduł:
platyPS

Tworzy zewnętrzny plik pomocy na podstawie języka Markdown obsługiwanego przez platformę PlatyPS.

Składnia

New-ExternalHelp
   -Path <String[]>
   -OutputPath <String>
   [-ApplicableTag <String[]>]
   [-Encoding <Encoding>]
   [-MaxAboutWidth <Int32>]
   [-ErrorLogFile <String>]
   [-Force]
   [-ShowProgress]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-ExternalHelp tworzy zewnętrzny plik pomocy na podstawie plików pomocy markdown obsługiwanych przez platformę PlatyPS. Możesz wysłać go za pomocą modułu, aby uzyskać pomoc przy użyciu polecenia cmdlet Get-Help.

Jeśli określone pliki markdown nie są zgodne zSchemat platyPS , to polecenie cmdlet zwraca komunikaty o błędach.

Przykłady

Przykład 1. Tworzenie pomocy zewnętrznej na podstawie zawartości folderu

PS C:\> New-ExternalHelp -Path ".\docs" -OutputPath "out\platyPS\en-US"

    Directory: D:\Working\PlatyPS\out\platyPS\en-US


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        5/19/2016  12:32 PM          46776 platyPS-help.xml

To polecenie tworzy zewnętrzny plik pomocy w określonej lokalizacji. To polecenie używa najlepszych rozwiązań, które nazwa folderu zawiera ustawienia regionalne.

Przykład 2. Tworzenie pomocy korzystającej z kodowania niestandardowego

PS C:\> New-ExternalHelp -Path ".\docs" -OutputPath "out\PlatyPS\en-US" -Force -Encoding ([System.Text.Encoding]::Unicode)


    Directory: D:\Working\PlatyPS\out\PlatyPS\en-US


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        5/22/2016   6:34 PM         132942 platyPS-help.xml

To polecenie tworzy zewnętrzny plik pomocy w określonej lokalizacji. To polecenie określa parametr Force, dlatego zastępuje istniejący plik. Polecenie określa kodowanie Unicode dla utworzonego pliku.

Przykład 3. Zapisywanie ostrzeżeń i błędów do pliku

PS C:\> New-ExternalHelp -Path ".\docs" -OutputPath "out\platyPS\en-US" -ErrorLogFile ".\WarningsAndErrors.json"

    Directory: D:\Working\PlatyPS\out\platyPS\en-US


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        5/19/2016  12:32 PM          46776 platyPS-help.xml

To polecenie tworzy zewnętrzny plik pomocy w określonej lokalizacji. To polecenie używa najlepszych rozwiązań, które nazwa folderu zawiera ustawienia regionalne. To polecenie zapisuje ostrzeżenia i błędy w pliku WarningsAndErrors.json.

Parametry

-ApplicableTag

Określ tablicę tagów do użycia jako filtr. Jeśli polecenie cmdlet applicable w metadanych yaml i żaden z przekazanych tagów nie zostanie tam wymieniony, polecenie cmdlet zostanie zignorowane w wygenerowanej pomocy. To samo dotyczy poziomu parametru applicable metadanych yaml. Jeśli applicable zostanie pominięta, polecenie cmdlet lub parametr będzie zawsze obecny. Aby uzyskać więcej informacji, zobacz problem z projektem.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Encoding

Określa kodowanie znaków dla zewnętrznego pliku pomocy. Określ obiekt System.Text.Encoding. Aby uzyskać więcej informacji, zobacz about_Character_Encoding.

Typ:Encoding
Position:Named
Domyślna wartość:UTF8 without BOM
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ErrorLogFile

Ścieżka, w której to polecenie cmdlet zapisuje sformatowany plik dziennika wyników.

Ścieżka musi zawierać lokalizację i nazwę folderu oraz nazwę pliku z rozszerzeniem json. Obiekt JSON zawiera trzy właściwości: Message, FilePathi Ważność (Ostrzeżenie lub Błąd).

Jeśli ta ścieżka nie zostanie podana, dziennik nie zostanie wygenerowany.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wskazuje, że to polecenie cmdlet zastępuje istniejący plik o tej samej nazwie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaxAboutWidth

Określa maksymalną długość wiersza podczas generowania "about" plików tekstowych pomocy. Ten parametr nie ma wpływu na inne typy plików pomocy. Aby uzyskać więcej informacji, zobacz New-MarkdownAboutHelp.

Wiersze wewnątrz bloków kodu nie są opakowane i nie mają wpływu na parametr MaxAboutWidth.

Typ:Int32
Position:Named
Domyślna wartość:80
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OutputPath

Określa ścieżkę folderu, w którym to polecenie cmdlet zapisuje zewnętrzny plik pomocy. Nazwa folderu powinna kończyć się folderem ustawień regionalnych, jak w poniższym przykładzie: .\out\PlatyPS\en-US\.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Określa tablicę ścieżek plików lub folderów markdown. To polecenie cmdlet tworzy zewnętrzną pomoc opartą na tych plikach i folderach.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-ShowProgress

Wyświetl paski postępu w obszarze analizowania istniejących plików markdown.

Jeśli jest to używane generowanie pomocy jest znacznie wolniejsze.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String[]

Możesz przekazać tablicę ścieżek do tego polecenia cmdlet.

Dane wyjściowe

FileInfo[]

To polecenie cmdlet zwraca obiekt FileInfo[] dla utworzonych plików.