How to add input types to a cmdlet help topic
Note
Manual authoring of XML-based help is very difficult. The PlatyPS module allows you to write help in Markdown and then convert it to XML-based help. This makes it much easier to write and maintain help. PlatyPS can also create the Updateable Help packages for you. For more information, see Create XML-based help using PlatyPS.
This section describes how to add an INPUTS section to a PowerShell cmdlet Help topic. The INPUTS section lists the .NET classes of objects that the cmdlet accepts as input from the pipeline, either by value or by property name.
There is no limit to the number of classes that you can add to an INPUTS section. The input
types are enclosed in a <command:inputTypes>
node, with each class enclosed in a
<command:inputType>
element.
The schema includes two <maml:description>
elements in each <command:inputType>
element.
However, the Get-Help
cmdlet displays only the content of the
<command:inputType>/<maml:description>
element.
Beginning in PowerShell 3.0, the Get-Help
cmdlet displays the content of the <maml:uri>
element.
This element lets you direct users to topics that describe the .NET class.
The following XML shows the <maml:inputTypes>
node.
<command:inputTypes>
<command:inputType>
<dev:type>
<maml:name> Class name </maml:name>
<maml:uri> URI of a topic that describes the class </maml:uri>
<maml:description/>
</dev:type>
<maml:description>
<maml:para> Brief description </maml:para>
</maml:description>
</command:inputType>
</command:inputTypes>
The following XML shows an example of using the <maml:inputTypes>
node to document an input type.
<command:inputTypes>
<command:inputType>
<dev:type>
<maml:name>System.DateTime</maml:name>
<maml:uri>https://learn.microsoft.com/dotnet/api/system.datetime</maml:uri>
<maml:description/>
</dev:type>
<maml:description>
<maml:para> You can pipe a date to the Set-Date cmdlet. <maml:para>
<maml:description>
</command:inputType>
</command:inputTypes>
PowerShell
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기