Merge-MarkdownHelp

Aynı cmdlet'in birden çok markdown sürümünü tek bir markdown dosyasında birleştirin.

Syntax

Default (Varsayılan)

Merge-MarkdownHelp
    [-Path] <String[]>
    [-OutputPath] <String>
    [-Encoding <Encoding>]
    [-ExplicitApplicableIfAll]
    [-Force]
    [[-MergeMarker] <String>]
    [<CommonParameters>]

Description

Benzer modüller veya aynı modülün farklı sürümleri genellikle yinelenen içerik içerir.

Merge-MarkdownHelp birden çok markdown dosyasını tek bir markdown dosyasında birleştirir. Hangi sürümlerin veya etiketlerin geçerli olduğunu belirlemek için applicable: yaml meta veri alanını kullanır. İki düzeyde hareket eder: cmdlet'in tamamı ve tek tek parametreler için.

Sonuçta elde edilen markdown, applicable: etiketlerinin yanı sıra özgün markdown dosyalarının tüm içeriğini içerir. Yinelenen içerik yok sayılır. Her dosyaya özgü içerik, birleştirme işaretçileri ve ardından virgülle ayrılmış bir geçerli etiketler listesi kullanılarak birleştirilir. birleştirme işaretçisi, birleştirilen içeriği tanımlamak için işaretçi işlevi gören bir metin dizesidir. Varsayılan birleştirme işaretçisi metin üç ünlem işaretinden oluşur !! ancak bu, -MergeMarker bayrağı kullanılarak ilgili herhangi bir metne değiştirilebilir.

Örnekler

Örnek 1

Test-CsPhoneBootstrap.md cmdlet'i hem Lync Server 2010 hem de Lync Server 2013'te bulunur. İçeriğin çoğu çoğaltılır ve bu nedenle her bir dosyadan benzersiz içerik birleştirilmiş cmdlet'i için tek bir dosyaya sahip olmak istiyoruz.

Merge-MarkdownHelp -Path @('Lync Server 2010\Test-CsPhoneBootstrap.md', 'Lync Server 2013\Test-CsPhoneBootstrap.md') -OutputPath lync

Sonuçta elde edilen dosya lync\Test-CsPhoneBootstrap.mdkonumunda bulunur.

Parametreler

-Encoding

Dış yardım dosyanız için karakter kodlamasını belirtir. System.Text.Encoding nesnesini belirtin. Daha fazla bilgi için bkz. about_Character_Encoding.

Parametre özellikleri

Tür:Encoding
Default value:UTF8 without BOM
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ExplicitApplicableIfAll

Her zaman geçerli etiketlerin tam listesini yazın. Varsayılan olarak tüm varyasyonlarda bulunan cmdlet'ler ve parametreler bir uygulama etiketi almaz.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Force

Bu cmdlet'in aynı ada sahip mevcut bir dosyanın üzerine yazdığını gösterir.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-MergeMarker

Birleştirme metin göstergesi olarak kullanılacak dize. İşaretçiden sonra geçerli etiket listesi eklenir

Parametre özellikleri

Tür:String
Default value:!!!
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:3
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-OutputPath

Bu cmdlet'in birleştirilmiş markdown yardım dosyalarını oluşturduğu klasörün yolunu belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Path

Markdown dosya veya klasörlerinin yol dizisini belirtir. Bu cmdlet, bu dosya ve klasörler temelinde birleştirilmiş markdown yardımı oluşturur.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Çıkışlar

FileInfo