en-US/Documentarian.MicrosoftDocs-help.xml
|
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml" xmlns="http://msh"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-CmdletXref</command:name> <command:verb>Get</command:verb> <command:noun>CmdletXref</command:noun> <maml:description> <maml:para>Gets a cross-reference link for a command.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Outputs a Learn platform cross-reference hyperlink for a command in Markdown syntax. The command can be an alias, the name of a proxy command, or the name of a cmdlet published in a module. The module must be installed on the local system.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-CmdletXref</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True" position="0" aliases="none"> <maml:name>Name</maml:name> <maml:description> <maml:para>The name of the command to get a cross-reference link for.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True" position="0" aliases="none"> <maml:name>Name</maml:name> <maml:description> <maml:para>The name of the command to get a cross-reference link for.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.String[]</maml:name> </dev:type> <maml:description> <maml:para>The cmdlet returns an array of strings, each representing a Markdown link using the Microsoft Learn platform xref syntax. Each link uses the command name for the link text and the xref string for the link URI.</maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para></maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>--- Example 1: Get a cross-reference link for some commands ---</maml:title> <dev:code>Get-CmdletXref Get-Command, Get-Help [Get-Command](xref:Microsoft.PowerShell.Core.Get-Command) [Get-Help](xref:Microsoft.PowerShell.Core.Get-Help)</dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>----- Example 2: Pipe multiple commands to Get-CmdletXref -----</maml:title> <dev:code>'oss','help','gcm', 'git', 'foo' | Get-CmdletXref -Verbose [Out-String](xref:Microsoft.PowerShell.Utility.Out-String) [Get-Help](xref:Microsoft.PowerShell.Core.Get-Help) VERBOSE: gcm is an alias for Get-Command [Get-Command](xref:Microsoft.PowerShell.Core.Get-Command) VERBOSE: git.exe is a(n) Application WARNING: Unable to find command foo</dev:code> <dev:remarks> <maml:para>The cross-reference links for successfully resolved commands are written to the Success output stream.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>----------- Example 3: Pipe results to the clipboard -----------</maml:title> <dev:code>'oss','help','gcm', 'git', 'foo' | Get-CmdletXref -Verbose | Set-Clipboard VERBOSE: gcm is an alias for Get-Command VERBOSE: git.exe is a(n) Application WARNING: Unable to find command foo</dev:code> <dev:remarks> <maml:para>The cross-reference links for successfully resolved commands are written to the Success output stream and copied to the clipboard.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>Online Version:</maml:linkText> <maml:uri>https://microsoft.github.io/Documentarian/modules/microsoftdocs/reference/cmdlets/get-cmdletxref</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-HtmlMetaTags</command:name> <command:verb>Get</command:verb> <command:noun>HtmlMetaTags</command:noun> <maml:description> <maml:para>Gets all of the HTML `<meta>` elements of a web page.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Gets all the HTML `<meta>` elements of a web page. This can be used to see the Docs metadata in the published article.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-HtmlMetaTags</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>ArticleUrl</maml:name> <maml:description> <maml:para>The URL to the Docs article you want to inspect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.Uri</command:parameterValue> <dev:type> <maml:name>System.Uri</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ShowRequiredMetadata</maml:name> <maml:description> <maml:para>Filters the output to show only the metadata require by the OPS publishing system.</maml:para> </maml:description> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>ArticleUrl</maml:name> <maml:description> <maml:para>The URL to the Docs article you want to inspect.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.Uri</command:parameterValue> <dev:type> <maml:name>System.Uri</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ShowRequiredMetadata</maml:name> <maml:description> <maml:para>Filters the output to show only the metadata require by the OPS publishing system.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.Management.Automation.SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para></maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>------------- Example 1 - Get the `ms.*` meta tags -------------</maml:title> <dev:code>$url = 'https://docs.microsoft.com/powershell/scripting/install/installing-powershell-core-on-windows' Get-HtmlMetaTags $url | Select-Object ms.* ms.author : sewhee ms.date : 08/02/2021 ms.devlang : powershell ms.prod : powershell ms.technology : powershell-conceptual ms.tgt_pltfr : windows, macos, linux ms.topic : conceptual</dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- Example 2 - Show only the require metadata ----------</maml:title> <dev:code>$url = 'https://docs.microsoft.com/powershell/scripting/install/installing-powershell-core-on-windows' Get-HtmlMetaTags $url -ShowRequiredMetadata title : og:title : Installing PowerShell on Windows - PowerShell description : Information about installing PowerShell on Windows ms.manager : ms.author : sewhee author : sdwheeler ms.service : ms.date : 08/02/2021 ms.topic : conceptual ms.subservice : ms.prod : powershell ms.technology : powershell-conceptual ms.custom : ROBOTS : INDEX, FOLLOW</dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>Online Version:</maml:linkText> <maml:uri>https://microsoft.github.io/Documentarian/modules/microsoftdocs/reference/cmdlets/get-htmlmetatags</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-LocaleFreshness</command:name> <command:verb>Get</command:verb> <command:noun>LocaleFreshness</command:noun> <maml:description> <maml:para>Gets the `ms.date` metadata information of a Docs article for every locale.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Gets the `ms.date` metadata information of a Docs article for every locale. The output includes the locale information and the translation method. This is useful to see that the localization process has picked up the latest changes made to the English version of the article.</maml:para> <maml:para>For comparison, the output of the cmdlet always includes the English version of the article.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-LocaleFreshness</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Uri</maml:name> <maml:description> <maml:para>The URL to the article being inspected. The URL must contain a supported locale.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.Uri</command:parameterValue> <dev:type> <maml:name>System.Uri</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Locale</maml:name> <maml:description> <maml:para>An array of one or more locale strings. The parameter default defaults to the following array of values:</maml:para> <maml:para>- `ar-sa`, `cs-cz`, `de-de`, `en-us`, `es-es`, `fr-fr`, `hu-hu`, `id-id`, `it-it`, `ja-jp`, `ko-kr`, `nl-nl`, `pl-pl`, `pt-br`, `pt-pt`, `ru-ru`, `sv-se`, `tr-tr`, `zh-cn`, `zh-tw`</maml:para> <maml:para>The value can be any of the locales supported by the docs platform:</maml:para> <maml:para>- `ar-sa`, `bg-bg`, `bs-latn-ba`, `ca-es`, `cs-cz`, `da-dk`, `de-at`, `de-ch`, `de-de`, `el-gr`, `en-au`, `en-ca`, `en-gb`, `en-ie`, `en-in`, `en-my`, `en-nz`, `en-sg`, `en-us`, `en-za`, `es-es`, `es-mx`, `et-ee`, `eu-es`, `fi-fi`, `fil-ph`, `fr-be`, `fr-ca`, `fr-ch`, `fr-fr`, `ga-ie`, `gl-es`, `he-il`, `hi-in`, `hr-hr`, `hu-hu`, `id-id`, `is-is`, `it-ch`, `it-it`, `ja-jp`, `ka-ge`, `kk-kz`, `ko-kr`, `lb-lu`, `lt-lt`, `lv-lv`, `ms-my`, `mt-mt`, `nb-no`, `nl-be`, `nl-nl`, `pl-pl`, `pt-br`, `pt-pt`, `ro-ro`, `ru-ru`, `sk-sk`, `sl-si`, `sr-cyrl-rs`, `sr-latn-rs`, `sv-se`, `th-th`, `tr-tr`, `uk-ua`, `vi-vn`, `zh-cn`, `zh-hk`, `zh-tw`</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>'ar-sa', 'en-us', 'cs-cz', 'de-de', 'es-es', 'fr-fr', 'hu-hu', 'id-id', 'it-it', 'ja-jp', 'ko-kr', 'nl-nl', 'pl-pl', 'pt-br', 'pt-pt', 'ru-ru', 'sv-se', 'tr-tr', 'zh-cn', 'zh-tw'</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none"> <maml:name>Locale</maml:name> <maml:description> <maml:para>An array of one or more locale strings. The parameter default defaults to the following array of values:</maml:para> <maml:para>- `ar-sa`, `cs-cz`, `de-de`, `en-us`, `es-es`, `fr-fr`, `hu-hu`, `id-id`, `it-it`, `ja-jp`, `ko-kr`, `nl-nl`, `pl-pl`, `pt-br`, `pt-pt`, `ru-ru`, `sv-se`, `tr-tr`, `zh-cn`, `zh-tw`</maml:para> <maml:para>The value can be any of the locales supported by the docs platform:</maml:para> <maml:para>- `ar-sa`, `bg-bg`, `bs-latn-ba`, `ca-es`, `cs-cz`, `da-dk`, `de-at`, `de-ch`, `de-de`, `el-gr`, `en-au`, `en-ca`, `en-gb`, `en-ie`, `en-in`, `en-my`, `en-nz`, `en-sg`, `en-us`, `en-za`, `es-es`, `es-mx`, `et-ee`, `eu-es`, `fi-fi`, `fil-ph`, `fr-be`, `fr-ca`, `fr-ch`, `fr-fr`, `ga-ie`, `gl-es`, `he-il`, `hi-in`, `hr-hr`, `hu-hu`, `id-id`, `is-is`, `it-ch`, `it-it`, `ja-jp`, `ka-ge`, `kk-kz`, `ko-kr`, `lb-lu`, `lt-lt`, `lv-lv`, `ms-my`, `mt-mt`, `nb-no`, `nl-be`, `nl-nl`, `pl-pl`, `pt-br`, `pt-pt`, `ro-ro`, `ru-ru`, `sk-sk`, `sl-si`, `sr-cyrl-rs`, `sr-latn-rs`, `sv-se`, `th-th`, `tr-tr`, `uk-ua`, `vi-vn`, `zh-cn`, `zh-hk`, `zh-tw`</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>'ar-sa', 'en-us', 'cs-cz', 'de-de', 'es-es', 'fr-fr', 'hu-hu', 'id-id', 'it-it', 'ja-jp', 'ko-kr', 'nl-nl', 'pl-pl', 'pt-br', 'pt-pt', 'ru-ru', 'sv-se', 'tr-tr', 'zh-cn', 'zh-tw'</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Uri</maml:name> <maml:description> <maml:para>The URL to the article being inspected. The URL must contain a supported locale.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.Uri</command:parameterValue> <dev:type> <maml:name>System.Uri</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>DocumentLocaleInfo</maml:name> </dev:type> <maml:description> <maml:para>The locpath property is the target path in the URL. The values of locpath , locale , and ms.contentlocale should match.</maml:para> <maml:para>The other properties are values of HTML `<meta>` tags in the published articles. The values of these tags are set by the build system when the article is published.</maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>This cmdlet depends on the `Get-HtmlMetaTags` cmdlet.</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>------ Example 1 - Get the freshness data for an article ------</maml:title> <dev:code>$url = 'https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux' Get-LocaleFreshness $url locpath locale ms.contentlocale ms.translationtype ms.date loc_version updated_at ------- ------ ---------------- ------------------ ------- ----------- ---------- en-us en-us 05/31/2022 2022-05-31 10:03 PM cs-cz cs-cz cs-cz MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM de-de de-de de-de HT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM es-es es-es es-es HT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM fr-fr fr-fr fr-fr HT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM hu-hu hu-hu hu-hu MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM id-id id-id id-id MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM it-it it-it it-it MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM ja-jp ja-jp ja-jp HT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM ko-kr ko-kr ko-kr HT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM nl-nl nl-nl nl-nl MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM pl-pl pl-pl pl-pl MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM pt-br pt-br pt-br HT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM pt-pt pt-pt pt-pt MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM ru-ru ru-ru ru-ru HT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM sv-se sv-se sv-se MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM tr-tr tr-tr tr-tr MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM zh-cn zh-cn zh-cn HT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM zh-tw zh-tw zh-tw MT 05/31/2022 2022-07-18T20:00:40.4523397Z 2022-08-17 10:12 PM</dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>Example 2 - Get the freshness data for an article for select languages</maml:title> <dev:code>$url = 'https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux' Get-LocaleFreshness $url pt-br, pt-pt locpath locale ms.contentlocale ms.translationtype ms.date loc_version updated_at ------- ------ ---------------- ------------------ ------- ----------- ---------- en-us en-us 01/09/2023 2023-09-05 09:55 PM pt-br pt-br pt-br HT 01/09/2023 2023-09-26T22:04:42.7240190Z 2023-10-13 11:23 PM pt-pt pt-pt pt-pt MT 01/09/2023 2023-10-26T21:59:59.7444562Z 2023-10-26 11:59 PM</dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> </command:example> <command:example> <maml:title>Example 3 - Get the full freshness data for an article for select languages</maml:title> <dev:code>$url = 'https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux' Get-LocaleFreshness $url pt-br | Format-List -Property * locpath : en-us locale : en-us ms.contentlocale : ms.translationtype : ms.date : 01/09/2023 loc_version : updated_at : 2023-09-05 09:55 PM loc_source_id : loc_file_id : original_content_git_url : https://github.com/MicrosoftDocs/PowerShell-Docs/blob/live/reference/docs-conceptual/install/In stalling-PowerShell-on-Linux.md locpath : pt-br locale : pt-br ms.contentlocale : pt-br ms.translationtype : HT ms.date : 01/09/2023 loc_version : 2023-09-26T22:04:42.7240190Z updated_at : 2023-10-13 11:23 PM loc_source_id : Github-44411511#live loc_file_id : Github-44411511.live.PowerShell.PowerShell_PowerShell-docs_reference.docs-conceptual/install/In stalling-PowerShell-on-Linux.md original_content_git_url : https://github.com/MicrosoftDocs/PowerShell-Docs/blob/live/reference/docs-conceptual/install/In stalling-PowerShell-on-Linux.md</dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>Online Version:</maml:linkText> <maml:uri>https://microsoft.github.io/Documentarian/modules/microsoftdocs/reference/cmdlets/get-localefreshness</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Sync-BeyondCompare</command:name> <command:verb>Sync</command:verb> <command:noun>BeyondCompare</command:noun> <maml:description> <maml:para>Provides a simple way to synchronize changes across multiple versions of a Markdown file.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Many docsets at Microsoft contain multiple versions of the same reference document. For example, we support multiple versions of PowerShell cmdlets. Each version contains the same cmdlet but there may be minor differences between the versions.</maml:para> <maml:para>When you make a change to the documentation for one of these cmdlet, it's often necessary to make the same change across all the supported versions.</maml:para> <maml:para>`Sync-BeyondCompare` reads the `monikerMapping.json` file in your repository to discover the version monikers and the file paths they map to. Using this version information, the cmdlet opens the file passed and one of the other versions of the same file for side-by-side comparison. When you close the application it opens the same file and the next version of the file. This repeats until you have opened and compared all versions.</maml:para> <maml:para>This cmdlet is dependent on the product Beyond Compare by Scooter Software. Beyond Compare is a visual diff tool that makes it easy to compare two files and copy differences from one file to the other. Microsoft has a site license to use this tool.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Sync-BeyondCompare</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Path</maml:name> <maml:description> <maml:para>The path to the updated file to use as the base for your comparison. The path must contain the version part of the path as defined in the `monikerMapping.json`.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Path</maml:name> <maml:description> <maml:para>The path to the updated file to use as the base for your comparison. The path must contain the version part of the path as defined in the `monikerMapping.json`.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para></maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>Sync-BeyondCompare reference/7.3/Microsoft.PowerShell.Core/About/about_Output_Streams.md</dev:code> <dev:remarks> <maml:para>The cmdlet opens the 7.3 and 5.1 versions of the file for comparison. You can copy the appropriate changes to or from either file. When you save and close the file, the cmdlet then opens the 7.3 and 7.2 versions for comparison. This process repeats until you have compared all versions.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>Online Version:</maml:linkText> <maml:uri>https://microsoft.github.io/Documentarian/modules/microsoftdocs/reference/cmdlets/sync-beyondcompare</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Beyond Compare</maml:linkText> <maml:uri>https://www.scootersoftware.com/index.php</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Sync-VSCode</command:name> <command:verb>Sync</command:verb> <command:noun>VSCode</command:noun> <maml:description> <maml:para>Provides a simple way to synchronize changes across multiple versions of a Markdown file.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Many docsets at Microsoft contain multiple versions of the same reference document. For example, we support multiple versions of PowerShell cmdlets. Each version contains the same cmdlet but there may be minor differences between the versions.</maml:para> <maml:para>When you make a change to the documentation for one of these cmdlet, it's often necessary to make the same change across all the supported versions.</maml:para> <maml:para>`Sync-VSCode` reads the `monikerMapping.json` file in your repository to discover the version monikers and the file paths they map to. Using this version information, the cmdlet opens the file passed and one of the other versions of the same file for side-by-side comparison. When you close the application it opens the same file and the next version of the file. This repeats until you have opened and compared all versions.</maml:para> <maml:para>This cmdlet is dependent on the product Visual Studio Code (VS Code) . VS Code has a visual diff mode that makes it easy to compare two files and copy differences from one file to the other.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Sync-VSCode</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Path</maml:name> <maml:description> <maml:para>The path the updated file that is the base for your comparison. The file path must contain the version portion of the path as defined in the `monikerMapping.json`.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Path</maml:name> <maml:description> <maml:para>The path the updated file that is the base for your comparison. The file path must contain the version portion of the path as defined in the `monikerMapping.json`.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para></maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>Sync-VSCode reference/7.3/Microsoft.PowerShell.Core/About/about_Output_Streams.md</dev:code> <dev:remarks> <maml:para>The cmdlet opens the 7.3 and 5.1 versions of the file for comparison. You can copy the appropriate changes to or from either file. When you save and close the file, the cmdlet then opens the 7.3 and 7.2 versions for comparison. This process repeats until you have compared all versions.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>Online Version:</maml:linkText> <maml:uri>https://microsoft.github.io/Documentarian/modules/microsoftdocs/reference/cmdlets/sync-vscode</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>Visual Studio Code</maml:linkText> <maml:uri>https://code.visualstudio.com</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Test-YamlTOC</command:name> <command:verb>Test</command:verb> <command:noun>YamlTOC</command:noun> <maml:description> <maml:para>Validates that all entries in the TOC exist and that all files in the repository are in the TOC.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>The command recursively searches the path provided to find `TOC.yml` files. It reads the content of each `TOC.yml` file and resolves the full path for each entry in the TOC. The command then checks if the file exists in the repository.</maml:para> <maml:para>The path provided must be a folder.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Test-YamlTOC</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Path</maml:name> <maml:description> <maml:para>The path to the TOC file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none"> <maml:name>Path</maml:name> <maml:description> <maml:para>The path to the TOC file.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">System.String</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>None</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Object</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para></maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>---------------- Example 1 - Verify a TOC file ----------------</maml:title> <dev:code>Test-YamlTOC -Path .\docs-conceptual FileExists IsInTOC FileName ---------- ------- -------- True False D:\Git\PS-Docs\PowerShell-Docs\reference\docs-conceptual\developer\bread\toc.yml True False D:\Git\PS-Docs\PowerShell-Docs\reference\docs-conceptual\developer\scheduling-jobs-with-th… True False D:\Git\PS-Docs\PowerShell-Docs\reference\docs-conceptual\toc.yml False True D:\Git\PS-Docs\PowerShell-Docs\reference\docs-conceptual\powershell\utility-modules\platyp…</dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>Online Version:</maml:linkText> <maml:uri>https://microsoft.github.io/Documentarian/modules/microsoftdocs/reference/cmdlets/test-yamltoc</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> </helpItems> |