Get-Help
Exibe informações sobre os comandos e conceitos do PowerShell.
Syntax
Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
[-Full]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]
Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
-Detailed
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]
Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
-Examples
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]
Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
-Parameter <String[]>
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]
Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
-Online
[<CommonParameters>]
Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
-ShowWindow
[<CommonParameters>]
Description
O Get-Help
cmdlet exibe informações sobre conceitos e comandos do PowerShell, incluindo cmdlets, funções, comandos CIM (Common Information Model), fluxos de trabalho, provedores, aliases e scripts.
Para obter ajuda para um cmdlet do PowerShell, digite Get-Help
seguido pelo nome do cmdlet, como: Get-Help Get-Process
.
Os artigos de ajuda conceitual no PowerShell começam com about_, como about_Comparison_Operators. Para ver todos os artigos about_ , digite Get-Help about_*
. Para ver um artigo específico, digite Get-Help about_<article-name>
, como Get-Help about_Comparison_Operators
.
Para obter ajuda para um provedor do PowerShell, digite Get-Help
seguido pelo nome do provedor. Por exemplo, para obter ajuda para o provedor de certificados, digite Get-Help Certificate
.
Você também pode digitar help
ou man
, que exibe uma tela de texto de cada vez. Ou , <cmdlet-name> -?
que é idêntico a Get-Help
, mas só funciona para cmdlets.
Get-Help
obtém o conteúdo de ajuda que ele exibe de arquivos de ajuda em seu computador. Sem os arquivos de ajuda, Get-Help
exibe apenas informações básicas sobre cmdlets. Alguns módulos do PowerShell incluem arquivos de ajuda. A partir do PowerShell 3.0, os módulos que vêm com o sistema operacional Windows não incluem arquivos de ajuda. Para baixar ou atualizar os arquivos de ajuda de um módulo no PowerShell 3.0, use o Update-Help
cmdlet .
Você também pode exibir os documentos de ajuda do PowerShell online. Para obter a versão online de um arquivo de ajuda, use o parâmetro Online , como: Get-Help Get-Process -Online
.
Se você digitar Get-Help
seguido pelo nome exato de um artigo de ajuda ou por uma palavra exclusiva para um artigo de ajuda, Get-Help
exibirá o conteúdo do artigo. Se você especificar o nome exato de um alias de comando, Get-Help
exibirá a ajuda para o comando original. Se você inserir um padrão de palavra ou palavra que aparece em vários títulos de artigo de ajuda, Get-Help
exibirá uma lista dos títulos correspondentes. Se você inserir qualquer texto que não apareça em nenhum título de artigo de ajuda, Get-Help
exibirá uma lista de artigos que incluem esse texto em seu conteúdo.
Get-Help
pode obter artigos de ajuda para todos os idiomas e localidades com suporte. Get-Help
primeiro procura arquivos de ajuda no conjunto de localidades para Windows, depois na localidade pai, como pt para pt-BR e, em seguida, em uma localidade de fallback. A partir do PowerShell 3.0, se Get-Help
não encontrar ajuda na localidade de fallback, ele procurará artigos de ajuda em inglês, en-US, antes de retornar uma mensagem de erro ou exibir ajuda gerada automaticamente.
Para obter informações sobre os símbolos exibidos Get-Help
no diagrama de sintaxe de comando, consulte about_Command_Syntax. Para obter informações sobre atributos de parâmetro, como Obrigatório e Posição, consulte about_Parameters.
Observação
No PowerShell 3.0 e no PowerShell 4.0, Get-Help
não é possível localizar Artigos sobre em módulos, a menos que o módulo seja importado para a sessão atual. Para obter artigos sobre em um módulo, importe o módulo usando o Import-Module
cmdlet ou executando um cmdlet incluído no módulo.
A partir do PSReadLine v2.2.2, o módulo é fornecido com duas funções que fornecem acesso rápido para ajudar enquanto você digita um comando na linha de comando. A ajuda é exibida no terminal em um buffer de tela alternativo com paginação.
Quando você atinge a tecla F1 , a função PSReadLineShowCommandHelp
invoca Get-Help -Full
para o nome do cmdlet mais próximo à esquerda do cursor. Quando o cursor é imediatamente à esquerda de um parâmetro, a função salta para a descrição desse parâmetro no tópico de ajuda completo. Ao clicar em Q para sair do modo de exibição de ajuda, você é retornado para a linha de comando na mesma posição do cursor para continuar digitando o comando.
Quando você usa a combinação de teclas Alt+h, a função PSReadLineShowParameterHelp
exibe informações de ajuda para o parâmetro imediatamente à esquerda do cursor. O texto da ajuda é exibido abaixo da linha de comando. Isso permite que você veja a descrição do parâmetro e continue digitando seu comando.
Para obter mais informações, consulte Usando ajuda dinâmica.
Exemplos
Exemplo 1: Exibir informações básicas de ajuda sobre um cmdlet
Esses exemplos exibem informações básicas de ajuda sobre o Format-Table
cmdlet.
Get-Help Format-Table
Get-Help -Name Format-Table
Format-Table -?
Get-Help <cmdlet-name>
é a sintaxe mais simples e padrão do Get-Help
cmdlet. Você pode omitir o parâmetro Name .
A sintaxe <cmdlet-name> -?
funciona apenas para cmdlets.
Exemplo 2: exibir informações básicas uma página de cada vez
Esses exemplos exibem informações básicas de ajuda sobre o Format-Table
cmdlet uma página de cada vez.
help Format-Table
man Format-Table
Get-Help Format-Table | Out-Host -Paging
help
é uma função que executa Get-Help
o cmdlet internamente e exibe o resultado uma página de cada vez.
man
é um alias para a help
função .
Get-Help Format-Table
envia o objeto pelo pipeline. Out-Host -Paging
recebe a saída do pipeline e exibe uma página por vez. Para obter mais informações, consulte Out-Host.
Exemplo 3: exibir mais informações para um cmdlet
Esses exemplos exibem informações de ajuda mais detalhadas sobre o Format-Table
cmdlet.
Get-Help Format-Table -Detailed
Get-Help Format-Table -Full
O parâmetro Detailed exibe a exibição detalhada do artigo de ajuda que inclui descrições de parâmetro e exemplos.
O parâmetro Full exibe a exibição completa do artigo de ajuda que inclui descrições de parâmetro, exemplos, tipos de objeto de entrada e saída e anotações adicionais.
Os parâmetros Detalhado e Completo são eficazes apenas para os comandos que têm arquivos de ajuda instalados no computador. Os parâmetros não são eficazes para os artigos de ajuda conceituais (about_).
Exemplo 4: exibir partes selecionadas de um cmdlet usando parâmetros
Esses exemplos exibem partes selecionadas da ajuda do Format-Table
cmdlet.
Get-Help Format-Table -Examples
Get-Help Format-Table -Parameter *
Get-Help Format-Table -Parameter GroupBy
O parâmetro Examples exibe as seções NAME e SYNOPSIS do arquivo de ajuda e todos os Exemplos. Não é possível especificar um número de exemplo porque o parâmetro Examples é um parâmetro de comutador.
O parâmetro Parameter exibe apenas as descrições dos parâmetros especificados. Se você especificar apenas o caractere curinga asterisco (*
), ele exibirá as descrições de todos os parâmetros.
Quando Parameter especifica um nome de parâmetro como GroupBy, as informações sobre esse parâmetro são mostradas.
Esses parâmetros não são eficazes para os artigos de ajuda conceituais (about_).
Exemplo 5: Exibir a versão online da ajuda
Este exemplo exibe a versão online do artigo de ajuda para o Format-Table
cmdlet no navegador da Web padrão.
Get-Help Format-Table -Online
Exemplo 6: Exibir ajuda sobre o sistema de ajuda
O Get-Help
cmdlet sem parâmetros exibe informações sobre o sistema de ajuda do PowerShell.
Get-Help
Exemplo 7: Exibir artigos de ajuda disponíveis
Este exemplo exibe uma lista de todos os artigos de ajuda disponíveis em seu computador.
Get-Help *
Exemplo 8: Exibir uma lista de artigos conceituais
Este exemplo exibe uma lista dos artigos conceituais incluídos na ajuda do PowerShell. Todos esses artigos começam com os caracteres about_. Para exibir um arquivo de ajuda específico, digite Get-Help \<about_article-name\>
, por exemplo, Get-Help about_Signing
.
Somente os artigos conceituais que têm arquivos de ajuda instalados no computador são exibidos. Para obter informações sobre como baixar e instalar arquivos de ajuda no PowerShell 3.0, consulte Update-Help.
Get-Help about_*
Exemplo 9: Pesquisa para uma palavra na ajuda do cmdlet
Este exemplo mostra como pesquisar uma palavra em um artigo de ajuda de cmdlet.
Get-Help Add-Member -Full | Out-String -Stream | Select-String -Pattern Clixml
the Export-Clixml cmdlet to save the instance of the object, including the additional members...
can use the Import-Clixml cmdlet to re-create the instance of the object from the information...
Export-Clixml
Import-Clixml
Get-Help
usa o parâmetro Full para obter informações de ajuda para Add-Member
. O objeto MamlCommandHelpInfo é enviado pelo pipeline. Out-String
usa o parâmetro Stream para converter o objeto em uma cadeia de caracteres. Select-String
usa o parâmetro Pattern para pesquisar a cadeia de caracteres para Clixml.
Exemplo 10: exibir uma lista de artigos que incluem uma palavra
Este exemplo exibe uma lista de artigos que incluem a palavra comunicação remota.
Quando você insere uma palavra que não aparece em nenhum título de artigo, Get-Help
exibe uma lista de artigos que incluem essa palavra.
Get-Help -Name remoting
Name Category Module Synopsis
---- -------- ------ --------
Install-PowerShellRemoting.ps1 External Install-PowerShellRemoting.ps1
Disable-PSRemoting Cmdlet Microsoft.PowerShell.Core Prevents remote users...
Enable-PSRemoting Cmdlet Microsoft.PowerShell.Core Configures the computer...
Exemplo 11: Exibir ajuda específica do provedor
Este exemplo mostra duas maneiras de obter a ajuda específica do provedor para Get-Item
. Esses comandos recebem ajuda que explica como usar o Get-Item
cmdlet no nó DataCollection do provedor de SQL Server do PowerShell.
O primeiro exemplo usa o Get-Help
parâmetro Path para especificar o caminho do provedor de SQL Server.
Como o caminho do provedor é especificado, você pode executar o comando de qualquer local de caminho.
O segundo exemplo usa Set-Location
para navegar até o caminho do provedor de SQL Server. Nesse local, o parâmetro Path não é necessário para Get-Help
obter a ajuda específica do provedor.
Get-Help Get-Item -Path SQLSERVER:\DataCollection
NAME
Get-Item
SYNOPSIS
Gets a collection of Server objects for the local computer and any computers
to which you have made a SQL Server PowerShell connection.
...
Set-Location SQLSERVER:\DataCollection
SQLSERVER:\DataCollection> Get-Help Get-Item
NAME
Get-Item
SYNOPSIS
Gets a collection of Server objects for the local computer and any computers
to which you have made a SQL Server PowerShell connection.
...
Exemplo 12: Exibir ajuda para um script
Este exemplo obtém ajuda para o MyScript.ps1 script
. Para obter informações sobre como escrever ajuda para suas funções e scripts, consulte about_Comment_Based_Help.
Get-Help -Name C:\PS-Test\MyScript.ps1
Parâmetros
-Category
Exibe ajuda apenas para itens na categoria especificada e seus aliases. Os artigos conceituais estão na categoria HelpFile .
Os valores aceitáveis para esse parâmetro são os seguintes:
- Alias
- Cmdlet
- Provedor
- Geral
- Perguntas frequentes
- Glossário
- HelpFile
- ScriptCommand
- Função
- Filtrar
- ExternalScript
- Tudo
- DefaultHelp
- Fluxo de trabalho
- DscResource
- Classe
- Configuração
Type: | String[] |
Accepted values: | Alias, Cmdlet, Provider, General, FAQ, Glossary, HelpFile, ScriptCommand, Function, Filter, ExternalScript, All, DefaultHelp, Workflow, DscResource, Class, Configuration |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Component
Exibe comandos com o valor do componente especificado, como o Exchange. Insira um nome de componente. Caracteres curinga são permitidos. Esse parâmetro não tem efeito em exibições de ajuda conceitual (About_).
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Detailed
Adiciona descrições de parâmetro e exemplos à exibição de ajuda básica. Esse parâmetro só é eficaz quando os arquivos de ajuda são instalados no computador. Ele não tem efeito em exibições de ajuda conceitual (About_).
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Examples
Exibe apenas o nome, sinopse e exemplos. Esse parâmetro só é eficaz quando os arquivos de ajuda são instalados no computador. Ele não tem efeito em exibições de ajuda conceitual (About_).
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Full
Exibe todo o artigo de ajuda para um cmdlet. Full inclui descrições e atributos de parâmetro, exemplos, tipos de objeto de entrada e saída e anotações adicionais.
Esse parâmetro só é eficaz quando os arquivos de ajuda são instalados no computador. Ele não tem efeito em exibições de ajuda conceitual (About_).
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Functionality
Exibe ajuda para os itens com a funcionalidade especificada. Insira a funcionalidade. Caracteres curinga são permitidos. Esse parâmetro não tem efeito em exibições de ajuda conceitual (About_).
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
Obtém ajuda sobre o comando ou conceito especificado. Insira o nome de um cmdlet, função, provedor, script ou fluxo de trabalho, como Get-Member
, um nome de artigo conceitual, como about_Objects
ou um alias, como ls
. Caracteres curinga são permitidos em nomes de cmdlet e provedor, mas você não pode usar caracteres curinga para encontrar os nomes dos artigos de ajuda de script e ajuda da função.
Para obter ajuda para um script que não está localizado em um caminho listado na $env:Path
variável de ambiente, digite o caminho e o nome do arquivo do script.
Se você inserir o nome exato de um artigo de ajuda, Get-Help
exibirá o conteúdo do artigo.
Se você inserir um padrão de palavra ou palavra que aparece em vários títulos de artigo de ajuda, Get-Help
exibirá uma lista dos títulos correspondentes.
Se você inserir qualquer texto que não corresponda a nenhum título de artigo de ajuda, Get-Help
exibirá uma lista de artigos que incluem esse texto em seu conteúdo.
Os nomes de artigos conceituais, como about_Objects
, devem ser inseridos em inglês, mesmo em versões que não sejam em inglês do PowerShell.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Online
Exibe a versão online de um artigo de ajuda no navegador padrão. Esse parâmetro é válido apenas para artigos de ajuda de cmdlet, função, fluxo de trabalho e script. Você não pode usar o parâmetro Online com Get-Help
em uma sessão remota.
Para obter informações sobre como dar suporte a esse recurso em artigos de ajuda que você escreve, consulte about_Comment_Based_Help e Suporte à Ajuda Online e Escrever Ajuda para Cmdlets do PowerShell.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Parameter
Exibe apenas as descrições detalhadas dos parâmetros especificados. Caracteres curinga são permitidos. Esse parâmetro não tem efeito em exibições de ajuda conceitual (About_).
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Path
Obtém ajuda que explica como o cmdlet funciona no caminho do provedor especificado. Insira um caminho de provedor do PowerShell.
Esse parâmetro obtém uma versão personalizada de um artigo de ajuda de cmdlet que explica como o cmdlet funciona no caminho do provedor do PowerShell especificado. Esse parâmetro é eficaz apenas para obter ajuda sobre um cmdlet de provedor e somente quando o provedor inclui uma versão personalizada do artigo de ajuda do cmdlet do provedor em seu arquivo de ajuda. Para usar este parâmetro, instale o arquivo de ajuda para o módulo que inclui o provedor.
Para ver a ajuda do cmdlet personalizado para um caminho de provedor, acesse o local do caminho do provedor e insira um Get-Help
comando ou, de qualquer local de caminho, use o parâmetro Path de Get-Help
para especificar o caminho do provedor. Você também pode encontrar ajuda de cmdlet personalizado online na seção de ajuda do provedor dos artigos de ajuda.
Para obter mais informações sobre provedores do PowerShell, consulte about_Providers.
Observação
O provedor do caminho especificado deve ter um arquivo de ajuda do provedor do PowerShell instalado. Se nenhum arquivo de ajuda do provedor estiver disponível, nenhuma informação de ajuda será retornada. Não há arquivos de ajuda do provedor disponíveis para os provedores incluídos nesta versão do PowerShell.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Role
Exibe a ajuda personalizada para a função de usuário especificada. Insira uma função. Caracteres curinga são permitidos.
Insira a função que o usuário desempenha em uma organização. Alguns cmdlets exibem texto diferente em seus arquivos de ajuda com base no valor deste parâmetro. Este parâmetro não tem nenhum efeito na ajuda para os cmdlets principais.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ShowWindow
Exibe o tópico da ajuda em uma janela para facilitar a leitura. A janela inclui um recurso localizar pesquisa e uma caixa Configurações que permite definir opções para a exibição, incluindo opções para exibir apenas as seções selecionadas de um tópico de ajuda.
O parâmetro ShowWindow dá suporte a tópicos de ajuda para comandos (cmdlets, funções, comandos CIM, scripts) e artigos conceituais Sobre . Ele não dá suporte à ajuda do provedor.
Esse parâmetro foi reintroduzido no PowerShell 7.0. Esse parâmetro só está disponível no Windows.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Você não pode canalizar objetos para este cmdlet.
Saídas
ExtendedCmdletHelpInfo
Se você executar Get-Help
em um comando que não tem um arquivo de ajuda, Get-Help
retornará um objeto ExtendedCmdletHelpInfo que representa a ajuda gerada automaticamente.
Se você receber um artigo de ajuda conceitual, Get-Help
o retornará como uma cadeia de caracteres.
MamlCommandHelpInfo
Se você receber um comando que tenha um arquivo de ajuda, Get-Help
retornará um objeto MamlCommandHelpInfo .
Observações
O PowerShell 3.0 não inclui arquivos de ajuda. Para baixar e instalar os arquivos de ajuda lidos Get-Help
, use o Update-Help
cmdlet . Você pode usar o Update-Help
cmdlet para baixar e instalar arquivos de ajuda para os comandos principais que vêm com o PowerShell e para todos os módulos instalados. Ele também pode ser usado para atualizar os arquivos de ajuda, de modo que a ajuda em seu computador nunca fique desatualizada.
Você também pode ler os artigos de ajuda sobre os comandos que vêm com o PowerShell online a partir de Introdução com Windows PowerShell.
Get-Help
exibe ajuda no conjunto de localidades para o sistema operacional Windows ou no idioma de fallback dessa localidade. Se você não tiver arquivos de ajuda para a localidade primária ou de fallback, Get-Help
se comportará como se não houvesse arquivos de ajuda no computador. Para obter ajuda para uma localidade diferente, use Região e Idioma em Painel de Controle para alterar as configurações. Em Windows 10 ou superior, Configurações, Linguagem de & de Tempo.
A exibição completa da ajuda inclui uma tabela de informações sobre os parâmetros. A tabela inclui os seguintes campos:
Obrigatório. Indica se o parâmetro é obrigatório (verdadeiro) ou opcional (falso).
Posição. Indica se o parâmetro é nomeado ou posicional (numérico). Parâmetros posicionais devem aparecer em um local especificado no comando.
Nomeado indica que o nome do parâmetro é necessário, mas que o parâmetro pode aparecer em qualquer lugar no comando.
Numérico indica que o nome do parâmetro é opcional, mas quando o nome é omitido, o parâmetro deve estar no local especificado pelo número. Por exemplo,
2
indica que quando o nome do parâmetro é omitido, o parâmetro deve ser o segundo ou único parâmetro sem nome no comando . Quando o nome do parâmetro é usado, o parâmetro pode aparecer em qualquer lugar no comando.Valor padrão. O valor do parâmetro ou o comportamento padrão que o PowerShell usa se você não incluir o parâmetro no comando.
Aceita a entrada de pipeline. Indica se você pode (true) ou não pode (false) enviar objetos para o parâmetro por meio de um pipeline. Por Nome da Propriedade significa que o objeto pipelined deve ter uma propriedade que tenha o mesmo nome que o nome do parâmetro.
Aceita caracteres curinga. Indica se o valor de um parâmetro pode incluir caracteres curinga, como um asterisco (
*
) ou ponto de interrogação (?
).