Tutorial do PowerShell 1 e 2 de 7: seu guia definitivo do PowerShell
Este tutorial do PowerShell é baseado no meu livro com o mesmo título. Você pode pegar o livro Amazonas .
Alternativamente, já que você está aqui, você pode ler o conteúdo do mesmo livro 100% grátis!
São 4 artigos com um total de 7 tutoriais. Este é o Tutorial do PowerShell 1 e 2 de 7
Se você é novo no PowerShell ou usa o PowerShell há algum tempo, você achará este tutorial útil.
Por fim, você pode usar o índice Procurar tópicos de postagem para navegar no tutorial. Usar o índice é particularmente útil se você não for novo no PowerShell, mas quiser aprender um tópico específico.
Procurar tópicos de postagem
- Tutorial 1 do PowerShell: Introdução ao PowerShell e aos cmdlets
- Tutorial 2 do PowerShell: Obtendo ajuda com o cmdlet Get-Help
- Parâmetros comuns
- Outras maneiras de usar o comando Get-Help
- Como aprender sobre a sintaxe de um comando
- Parâmetros detalhados, completos e online do cmdlet Get-Help
- Como usar o parâmetro 'Exemplos' do Get-Help
- Como atualizar as informações de ajuda do cmdlet com o comando Update-Help
- Referências e leitura adicional para o Tutorial 2 do PowerShell
Tutorial 1 do PowerShell: Introdução ao PowerShell e aos cmdlets
Neste primeiro tutorial, apresentarei o PowerShell. Para leitores novos no PowerShell, a primeira seção deste tutorial funcionará como uma introdução rápida a essa ferramenta interessante.
No entanto, para leitores que tenham algum conhecimento do PowerShell, ele funcionará como uma atualização. Há algo para cada leitor neste tutorial.
Este tutorial também abrange os cmdlets do PowerShell (Command-Lets) e mostra como localizar cmdlets usando o cmdlet Get-Command. O tutorial abrange cmdlets em detalhes, incluindo como eles são nomeados em pares Verbo-Substantivo.
Por fim, o tutorial conclui ensinando parâmetros e aliases do Cmdlet. Você também aprenderá o recurso de conclusão de comando do PowerShell.
O que é PowerShell?
Wikipédia define o Windows PowerShell como uma estrutura de gerenciamento de configuração e automação de tarefas. A Microsoft o define como um novo shell de linha de comando do Windows projetado especialmente para administradores de sistema.
Eu defino o Windows PowerShell como uma ferramenta de linha de comando e script criada para administradores de sistemas Windows para fins de automação de tarefas do Windows.
root s7 edge nougat
Para um novato que está lendo isso, uma maneira de apresentar facilmente o PowerShell é relacioná-lo ao prompt de comando do Windows. No entanto, relacionar o PowerShell ao CMD legado prejudica o PowerShell – mas é a maneira mais fácil de apresentar essa ferramenta a você.
Como abrir o Windows PowerShell
Agora que você sabe o que é o PowerShell, a próxima parte lógica deste tutorial é mostrar como abrir o PowerShell. Para abrir o Windows PowerShell, use um dos métodos abaixo:
- Procurar powershell . Em seguida, nos resultados da pesquisa, clique em Windows PowerShell .
- Como alternativa, você pode abrir o PowerShell clicando com o botão direito do mouse no Menu Iniciar. Em seguida, selecione Corre . Quando Executar Abre, digite powershell e clique em OK.
Como você pode ver, o console de comando do PowerShell se parece com o prompt de comando herdado do Windows. No entanto, há mais do que isso.
Acho que a próxima coisa lógica que você quer aprender neste tutorial é começar a executar comandos do PowerShell! Ainda não. Deixe-me tirar algumas coisas menores, mas importantes, primeiro.
Como a maioria dos aplicativos, o PowerShell vem em diferentes versões. É importante que você conheça a versão do PowerShell que está executando. Além disso, também é importante saber como atualizar o Windows PowerShell, se necessário.
Há duas maneiras de determinar sua versão atual do PowerShell. Executando um dos comandos abaixo:
|_+_| |_+_|Aqui estão os resultados de ambos os comandos. Para saber mais, leia nosso artigo – Como verificar a versão atual do PowerShell.
Introdução aos cmdlets
Até agora, neste tutorial do PowerShell, você sabe o que é o PowerShell. Além disso, agora você conhece dois métodos para abrir o Windows PowerShell.
Também mostrei como verificar sua versão do PowerShell.
Nesta subseção do tutorial, apresentarei os Cmdlets do PowerShell.
O Windows PowerShell executa comandos usando Cmdlets (Command-Lets). Cmdlet é um conceito totalmente novo introduzido com o PowerShell. Eles são ferramentas de linha de comando incorporadas ao shell no PowerShell.
Cmdlets são normalmente feitos de duas palavras em inglês. A primeira palavra é um verbo, enquanto a segunda é um substantivo.
Um cmdlet Verbo e os seus Substantivo são separados por um hífen (-), e escritos como um par Verbo-Substantivo.
A parte verbal de um cmdlet geralmente é uma palavra de ação, enquanto a parte Substantiva é a identidade na qual a ação é executada. Por exemplo Get-Command .
O Verbo parte deste cmdlet é 'Get' enquanto o Substantivo parte (o objeto no qual a ação 'Get' é executada) é 'Command'. Esta é a convenção de nomenclatura padrão de cmdlets.
Embora o PowerShell use a parte verbal de um cmdlet para implicar ações, no entanto, a palavra pode não ser necessariamente um verbo inglês padrão. Por exemplo, a palavra 'Novo' é um verbo do PowerShell, mas não é um verbo em inglês.
Os cmdlets do Windows PowerShell são nomeados em Verbo substantivo pares. A porção Verbo identifica a ação a ser executada enquanto a porção Substantiva identifica a entidade na qual essa ação é executada. Os verbos do PowerShell podem não ser necessariamente verbos do idioma inglês.Outra coisa importante a ser observada sobre os cmdlets é que a combinação Verbo-Substantivo geralmente descreve o que o cmdlet realiza. Por exemplo, Obter ajuda .
Isso, como a maioria dos cmdlets do PowerShell, é descritivo do que faz. Obter ajuda significa obter ajuda!
Outro exemplo é o Get-Command Cmdlet. Este cmdlet retorna informações sobre outros comandos ou cmdlets do PowerShell.
Para esclarecer meu ponto, vamos examinar alguns verbos do PowerShell e ver o raciocínio por trás deles.
O verbo 'Adicionar' adiciona um recurso a um contêiner. Por exemplo, o cmdlet Adicionar conteúdo , adiciona informações adicionais a um arquivo.
Além disso, o verbo 'Set' é usado para substituir os dados existentes. Por exemplo, para alterar os detalhes de um usuário do Active Directory, você usaria o cmdlet Set-ADUser .
Essa consistência nos nomes dos cmdlets facilita lembrá-los e usá-los.
Os exemplos abaixo ilustram os pontos nos parágrafos anteriores.
O comando abaixo cria um novo arquivo de texto, Outfile.txt. Ele também adiciona a frase Esta é a primeira linha do arquivo de texto Outfile.txt ao arquivo.
|_+_|O cmdlet Arquivo de saída ilustra a convenção de nomenclatura Verbo-Substantivo de Cmdlets. Além disso, também ilustra a natureza descritiva dos cmdlets do PowerShell.
No último comando, usei o pipeline, (|). Abordarei os pipelines no Tutorial 3 do PowerShell.
Palavras reservadas do PowerShell
No Windows PowerShell, algumas palavras têm significados especiais. Essas palavras com significados especiais são chamadas de palavras reservadas.
Quando você usa qualquer uma das palavras reservadas em um script sem aspas, o Windows PowerShell tenta aplicar o significado especial atribuído à palavra.
Algumas das palavras reservadas no PowerShell são Function, Try, Catch, If, Else, ElseIf, Break, ForEach e In.
Introduzi intencionalmente essas palavras reservadas no início deste tutorial do PowerShell porque usaremos várias delas à medida que progredirmos. Se você deseja obter informações sobre qualquer uma dessas palavras reservadas, execute o comando Get-Help about_ReservedWord.
Por exemplo, para obter informações sobre o ForEach, execute o comando abaixo:
|_+_|Aqui está o resultado do comando.
O Tutorial 2 do PowerShell cobre o Obter ajuda comando. Ele também abordará os tópicos do Windows PowerShell Core.
Além disso, no Tutorial 2 do PowerShell, você aprenderá muito mais sobre como encontrar informações sobre palavras reservadas do PowerShell usando o Obter ajuda Cmdlet.
Parâmetros de cmdlet, aliases e conclusão de comandos
No último tutorial do PowerShell, você aprendeu que os cmdlets do PowerShell são nomeados em pares verbo-substantivo. Esta seção apresenta outro conceito importante de cmdlet chamado parâmetros
Um parâmetro de cmdlet é o mecanismo que permite que um cmdlet aceite entrada. Significa simplesmente que um parâmetro permite que você insira informações em um cmdlet.
Sintaxe de um parâmetro de cmdlet
Neste tutorial do PowerShell, você encontrará a palavra 'Sintaxe' várias vezes. Um comando do PowerShell sintaxe informa a maneira correta de executar comandos usando um cmdlet do PowerShell.
Abaixo está a sintaxe de um parâmetro de cmdlet:
|_+_|No exemplo de sintaxe acima, ‘Cmdlet_Name’ representa um cmdlet. O nome do parâmetro vem após o cmdlet.
Antes de adicionar um nome de parâmetro, você deve adicionar um hífen (-). Finalmente, você deve adicionar o valor do parâmetro.
Por exemplo, o Get-Command cmdlet tem um parâmetro chamado Nome . Se eu quiser verificar se um cmdlet chamado Get-Processo estiver instalado no meu sistema, executarei o comando abaixo:
|_+_|
No comando anterior, ‘Get-Command’ é o cmdlet. ‘Name’ é o nome do parâmetro enquanto ‘Get-Process’ é o valor do parâmetro.
Ainda no último exemplo, o parâmetro 'Nome' forneceu uma maneira de alimentar a entrada no Get-Command cmdlet.
Um parâmetro permite que um cmdlet aceite entradas. Além disso, um cmdlet normalmente terá vários parâmetros. Por fim, um parâmetro Cmdlet geralmente vem após um cmdlet seguido pelo valor do parâmetro.Se um parâmetro de cmdlet me permite alimentar entradas no cmdlet, significa que posso alimentar diferentes entradas no mesmo cmdlet para obter resultados diferentes. Anteriormente, alimentamos ‘Get-Process’ no parâmetro ‘Name’ do Get-Command cmdlet.
No próximo exemplo, alimentarei um valor diferente. Digamos que queremos verificar se o cmdlet, Get-WMIObject está no meu PC, Get-WMIObject então substituirá Get-Processo como meu valor de parâmetro, conforme mostrado abaixo:
|_+_|
Tipos de parâmetros de cmdlet
Alguns parâmetros de cmdlet aceitam valores de entrada, outros não. Os parâmetros que aceitam valores de entrada são chamados de ‘Strings’.
Por outro lado, os parâmetros do Cmdlet que não aceitam valores de entrada são chamados de ‘switches’.
Na última seção, dei alguns exemplos de um parâmetro que aceita ou requer entradas. Um exemplo de parâmetro que não requer nenhum valor de entrada é o parâmetro ‘Recurse’ encontrado no Get-ChildItem cmdlet.
remover bloatware acender fogo
O Get-ChildItem cmdlet exibe os itens e itens filho em um ou mais locais especificados. Se o item em questão for um contêiner (uma pasta, por exemplo), Get-ChildItem recupera os itens dentro do contêiner.
Os itens dentro do contêiner são conhecidos como itens filhos.
Por padrão, Get-ChildItem recupera apenas itens no contêiner principal. No entanto, se você deseja recuperar informações sobre itens em todos os contêineres filho, use o parâmetro ‘Recurse’.
Para ilustrar o conceito de contêineres pai e filho, observe as pastas em D:G-Drive-P nesta captura de tela.
O Get-ChildItem O cmdlet pode exibir os itens na pasta G-Drive-P. No entanto, se executarmos o comando, sem especificar o parâmetro ‘Recurse’, o Get-ChildItem exibirá apenas os itens da pasta D:G-Drive-P.
|_+_|
Como alternativa, para exibir todos os itens na pasta superior e em todas as subpastas, especifique o parâmetro ‘Recurse’.
|_+_|O último comando com o parâmetro ‘Recurse’ ilustra um tipo de parâmetro chamado parâmetro ‘switche’. Observe que, ao contrário do outro parâmetro que discutimos anteriormente, o parâmetro ‘Recurse’ não requer uma entrada.
Conclusão do comando do PowerShell
Nesta parte do tutorial 1 do PowerShell, você aprenderá sobre um recurso de cmdlet do PowerShell muito útil – Conclusão de Comando.
A funcionalidade de conclusão de comando do PowerShell fornece a capacidade de completar comandos automaticamente para você. Quando você digita uma parte de um cmdlet e pressiona a tecla tab, o shell conclui o comando para você.
A conclusão do comando pode ser usada para cmdlets, bem como a conclusão do parâmetro.
Por exemplo, supondo que você deseja encontrar o Get-Command cmdlet, mas você esqueceu o nome completo do cmdlet. Você poderia digitar Get-Co em seguida, pressione a tecla tab.
Com base nos comandos que tenho no meu computador, o shell retornou Get-Command , Get-ComputerRestorePoint , Get-Conten t, etc. Conforme eu pressiono a tecla tab, o shell retorna mais e mais cmdlets.
Com essa funcionalidade, você não precisa memorizar cmdlets – embora à medida que você cria scripts mais e mais, você se acostuma com alguns cmdlets. No entanto, a conclusão do comando continuará sendo útil em sua vida de script!
Continuando com o nosso Get-Command Por exemplo, depois de encontrar o cmdlet usando a conclusão do comando, talvez você queira localizar os parâmetros associados ao cmdlet. Para conseguir isso, adicione um espaço após Get-Command – digite hífen (-).
Em seguida, pressione a tecla Tab mais uma vez. Continue pressionando a tecla tab para ver todos os parâmetros associados ao cmdlet (neste caso, Get-Command).
Alias de cmdlet do PowerShell
As duas últimas funcionalidades úteis no PowerShell que desejo apresentar a você são aliases, realce para copiar e clique com o botão direito do mouse para colar.
A maioria dos cmdlets do PowerShell terá um alias. Os aliases são nomes alternativos para cmdlets e comandos.
Os aliases são formas abreviadas de um cmdlet.
Além disso, no PowerShell, um alias é um nome ou apelido alternativo para um cmdlet. Um elemento de comando, como uma função, script, arquivo ou arquivo executável também pode ter um alias.
A maioria das pessoas usa aliases em comandos e scripts para reduzir o número de letras que digitam. Os aliases também podem ser mais fáceis de lembrar.
No entanto, prefiro usar o nome completo de Cmdlets. Acredito que usar o nome completo de um cmdlet o torna facilmente reconhecível.
Por fim, para esta seção, para listar aliases de Cmdlets em seu computador, use o comando abaixo:
|_+_| Eu canalizei a saída do cmdlet Get-Alias para More porque espero que a saída seja muito longa. Ao canalizar a saída para Mais, o shell exibirá os resultados na janela atual. Para exibir mais resultados, pressione a tecla Enter no teclado. Para cancelar os resultados e retornar ao prompt do PowerShell, pressione Ctrl e C teclas simultaneamente ( Ctrl + C )
Do resultado do último comando, % é o alias para ForEach-Object. Além disso, ? é o alias para o cmdlet Where-Object.
Seguindo em frente, se você conhece o alias de um cmdlet e deseja encontrar o nome completo do cmdlet, use esta sintaxe de comando:
|_+_|Substitua Alias_Name pelo alias do cmdlet que você deseja obter seu nome completo. Por exemplo, para obter o cmdlet completo para gwmi, use o comando abaixo:
Software de música de 8 bits|_+_|
Interessante não é. Com base no resultado do comando, o nome completo do Cmdlet com alias gwmi é Get-WmiObject . Você também pode usar um curinga, por exemplo, Get-Alias – Me dê um nome* como mostrado abaixo.
Por fim, nesta seção, mostrarei como copiar e colar em um shell do PowerShell. Para ilustrar, para copiar o Get-WmiObject Cmdlet nesta captura de tela, destaque todo o texto.
Em seguida, pressione a tecla Enter no teclado. Por fim, para colar o item copiado no prompt de comando do PowerShell, clique com o botão direito do mouse em qualquer lugar do shell.
Espero que você esteja gostando deste tutorial do PowerShell. Lembre-se de nos dar seus comentários usando o formulário DEIXE UMA RESPOSTA no final desta página.
Você também pode rolar para baixo até a postagem Esta postagem foi útil? seção no final do post e fornecer seus comentários.
Como encontrar cmdlets usando Get-Command
Abra um console do PowerShell e execute o comando abaixo:
|_+_|O comando exibe uma lista de cmdlets em seu computador. Como expliquei anteriormente, canalizar a saída para Mais exibe os resultados na tela – e oferece a opção de pressionar a tecla Enter para exibir mais resultados.
O resultado do comando tem quatro colunas – ‘CommandType’, ‘Name’, ‘Version’ e ‘Source’. A coluna 'CommandType' exibe 'Alias', 'Function' ou 'Cmdlet'.
Como você deve ter percebido, executar o Get-Command sem quaisquer parâmetros não é muito útil. Na próxima subseção, ensinarei como usar Get-Command parâmetros para exibir resultados mais informativos.
Sintaxe do cmdlet Get-Command
A sintaxe mais simples do cmdlet Get-Command é:
|_+_|Para encontrar um cmdlet específico, digite Get-Command , seguido pelo nome do cmdlet. No entanto, se você conhecer partes do cmdlet de que precisa, poderá localizar o nome real do cmdlet adicionando curingas.
Por exemplo, para localizar todos os cmdlets com o Substantivo ‘Data’, execute o comando abaixo:
|_+_|Alternativamente, você pode usar o comando abaixo:
|_+_|Ambos os comandos retornam os mesmos resultados.
O Get-Command O cmdlet é útil se você precisar encontrar um cmdlet para executar tarefas específicas. Por exemplo, para localizar um cmdlet que possa comparar dois grupos do Active Directory, você pode adivinhar que o cmdlet provavelmente conterá o verbo comparar.
O próximo passo é usar o Get-Command Cmdlet para exibir todos os cmdlets que contêm o verbo comparar. Aqui está o comando que pode listar os cmdlets que precisamos:
|_+_|Bingo! Temos nosso Cmdlet – Compare-Object!
Se você leu este tutorial do PowerShell desde o início, concordará que conseguimos encontrar o Cmdlet de que precisamos devido ao conhecimento do formato Verb-Noun dos Cmdlets.Verbos de cmdlet do PowerShell aprovados
Neste tutorial do PowerShell, você sabe que os cmdlets do PowerShell são nomeados em pares verbo-substantivo. O Windows PowerShell tem uma lista de cmdlets, funções e módulos de verbos usados aprovados.
Além disso, usar uma lista de verbos aprovados no PowerShell tem dois benefícios – a), incentiva a consistência – b), facilita a memorização de cmdlets.
Os verbos aprovados são agrupados em sete tipos - 'Comum', 'Comunicações', 'Dados', 'Diagnóstico', 'Ciclo de vida', 'Segurança' e 'Outros verbos'. Para exibir a lista completa de verbos de Cmdlet aprovados, execute o comando abaixo:
|_+_|
Saber como obter essa lista facilita a localização dos cmdlets necessários para automatizar tarefas com o PowerShell.
No tutorial 4 do PowerShell, apresentarei Scripts, Functions e Modules.Referências e leitura adicional para o Tutorial 1 do PowerShell
- Instalando o PowerShell no Windows
- Verbos de cmdlet do PowerShell aprovados
- Parâmetros do cmdlet
- Página da Wikipedia para Windows PowerShell
- Introdução ao Windows PowerShell (Microsoft.com)
- Palavras reservadas do PowerShell
- Cmdlet Get-Command (Microsoft.com)
Este tutorial é baseado no meu livro com o mesmo título. Você pode obtê-lo de Amazonas .
Tutorial 2 do PowerShell: Obtendo ajuda com o cmdlet Get-Help
No Tutorial 1 do PowerShell, discutimos os cmdlets. O tutorial também abordou como encontrar outros cmdlets usando o Get-Command Cmdlet.
Quando você encontra um cmdlet, é provável que não saiba como usá-lo. Você pode precisar de coisas como a sintaxe e os parâmetros do cmdlet.
Além disso, você também pode querer ver exemplos de como usar o Cmdlet.
Como qualquer outra ferramenta no Windows, o PowerShell possui uma funcionalidade de ajuda integrada. Além disso, a maioria dos cmdlets do PowerShell possui informações de ajuda internas.
O Obter ajuda O cmdlet fornece informações sobre qualquer cmdlet acessando a ajuda interna do cmdlet. Além de usar o cmdlet Get-Help, você também pode encontrar informações úteis sobre cmdlets online.
Este segundo tutorial se aprofunda no PowerShell Obter ajuda Cmdlet.
Na minha opinião, o Obter ajuda O cmdlet é um dos cmdlets mais importantes que você precisará em sua carreira de script do PowerShell. A razão para isso é simples: é um Cmdlet que o ajudará a encontrar outros Cmdlets – o que pode ser mais importante!
Além disso, o Obter ajuda O cmdlet não apenas exibe informações úteis sobre outros cmdlets. Ele também exibe informações sobre funções, comandos CIM, fluxos de trabalho, provedores, aliases e scripts.
Aqui está a sintaxe mais simples do Obter ajuda comando:
|_+_|Há mais parâmetros do cmdlet Get-Help. No entanto, incluí os parâmetros comuns.
Se você precisar obter informações sobre um cmdlet, digite Obter ajuda , seguido pelo Cmdlet. Por exemplo, Get-Command Cmdlet, use o comando abaixo:
|_+_|O comando exibe as seções básicas de ajuda – NOME, SINOPSE, SINTAXE, DESCRIÇÃO, LINKS RELACIONADOS e OBSERVAÇÕES.
A seção mais importante é a SYNTAX – mostra como usar o Cmdlet e seus parâmetros. Este tutorial do PowerShell abrange as sintaxes na seção 2.2.
Parâmetros comuns
O PowerShell tem um conjunto de parâmetros chamado Parâmetros Comuns. Esses parâmetros são comuns a todos os cmdlets do PowerShell.
Em outras palavras, um cmdlet não precisa especificar esses parâmetros para que estejam disponíveis no cmdlet.
No tutorial anterior, vimos que a seção SYNTAX é uma das seções do resultado do comando Get-Help. Se você observar atentamente a sintaxe de qualquer cmdlet do PowerShell, verá.
Isso significa simplesmente que você pode usar qualquer um dos parâmetros comuns do PowerShell incorporados nesse cmdlet.
A tabela abaixo é uma lista de parâmetros comuns no PowerShell e o que eles fazem.
| S/N | Parâmetro comum do PowerShell | O que o parâmetro comum faz |
|---|---|---|
| 1 | Detalhado | Exibe a operação detalhada de um comando. |
| dois | Depurar | Esse parâmetro comum exibe informações em nível de código sobre a operação executada por um comando. |
| 3 | ErrorAction | Informa ao PowerShell como lidar com erros de encerramento |
| 4 | Variável de erro | Armazena mensagens de erro em uma variável especificada. As mesmas mensagens de erro também são armazenadas na variável automática $Error. |
| 5 | Ação de Aviso | Semelhante a ErrorAction – controla como um cmdlet responde a mensagens de aviso de um comando. |
| 6 | Variável de Aviso | WarningVariable é semelhante a ErrorVariable. No entanto, em vez de registrar mensagens de erro em uma variável especificada, a WarningVariable registra mensagens de aviso. |
| 7 | OutBuffer | Esse parâmetro comum determina o número de objetos salvos no buffer antes que os objetos sejam enviados pelo pipeline. |
| 8 | PipelineVariable | Use um PipelineVariable para armazenar o valor do elemento de pipeline atual como uma variável |
| 9 | OutVariable | Armazena a saída de um comando em uma variável que você especifica. O comando também será enviado para o pipeline |
Para saber mais sobre parâmetros comuns, visite o Sobre parâmetros comuns página da Microsoft.
Para ilustrar o uso de parâmetros comuns, vejamos o ErrorAction parâmetro comum. Se executarmos o Get-Command e fornecer um cmdlet que não existe, uma mensagem de erro será gerada.
Por exemplo, execute o comando abaixo:
|_+_|O comando lançará uma mensagem de erro porque o Get Cmdlet não existe no PowerShell.
No entanto, para interromper a exibição da mensagem de erro, use este comando:
|_+_|Woola! Nenhuma mensagem de erro desta vez. A mensagem de erro é suprimida pelo parâmetro comum ErrorAction, Continuar Silenciosamente .
Como você deve ter adivinhado o ErrorAction parâmetro comum tem outros valores de entrada. Para ver outras opções de entrada, adicione um espaço após – ErrorAction e pressione a tecla tab no teclado. Continue pressionando a tecla tab para exibir mais opções.Outras maneiras de usar o comando Get-Help
Nesta seção 1.3.1 do tutorial do PowerShell, apresentei as Palavras Reservadas do PowerShell . O Obter ajuda O cmdlet também oferece informações úteis sobre palavras reservadas do PowerShell.
Para obter informações sobre uma palavra reservada e como usá-la no PowerShell, use Get-Help about_ReservedWord. Por exemplo, para saber mais sobre a palavra reservada, SE, use o comando abaixo:
|_+_|O comando acima exibe informações sobre o E SE instrução condicional e como usá-la.
Continuando com os tópicos sobre – no tutorial 2.1 do PowerShell, discutimos os parâmetros comuns. Há um tópico de ajuda sobre parâmetros comuns.
Para obter informações sobre Parâmetros Comuns (incluindo exemplos), execute o comando abaixo:
|_+_|O comando exibe informações sobre Parâmetros comuns . Eu canalizei o comando para Mais para que o PowerShell exiba o resultado por página e me permita exibir mais informações conforme necessário.
Como aprender sobre a sintaxe de um comando
Este tutorial já deu dicas sobre as sintaxes de cmdlet do PowerShell. Uma sintaxe de comando Cmdlet ajuda você a construir comandos corretamente.
Nesta seção do tutorial do PowerShell, vou me aprofundar um pouco mais na seção SYNTAX do comando Get-Help para um cmdlet. Para iniciar esta seção do tutorial, execute o comando abaixo:
|_+_|A seção SYNTAX dos resultados informa como usar o Get-ADUser Cmdlet – incluindo todos os seus parâmetros e como usá-los.
Se você olhar um pouco mais de perto na seção SYNTAX, você notará que existem três conjuntos de Get-ADUser sintaxes de comando.
Em primeiro lugar, você pode usar o Get-ADUser comando com o -Filtro parâmetro. Alternativamente, você também pode usar o mesmo comando com o -Identidade parâmetro.
Por fim, você também pode usar o Get-ADUser comando com o -Filtro LDAP parâmetro.
Esses três parâmetros principais NÃO PODEM ser usados no mesmo comando. Se você usar qualquer um dos dois parâmetros no mesmo comando, receberá uma mensagem de erro – O conjunto de parâmetros não pode ser resolvido usando os parâmetros nomeados especificados .
Sempre que você executa um comando do PowerShell e recebe essa mensagem de erro, é provável que você combinou os nomes de conjunto de parâmetros incorretos. Para corrigir o erro, consulte a seção de sintaxe do resultado do comando Get-Help para esse cmdlet.
A seção SYNTAX do comando Get-Help fornecerá a maneira correta de combinar os parâmetros do Cmdlet.
Parâmetros detalhados, completos e online do cmdlet Get-Help
Como qualquer outro cmdlet, o Obter ajuda O cmdlet tem alguns parâmetros. No início desta seção, vimos o resultado básico produzido pela Obter ajuda Comando.
No entanto, podemos aprender mais sobre um comando aplicando outros parâmetros do Obter ajuda Cmdlet.
como fazer download qbittorrent mais rápido
Para continuar com o cmdlet Get-Command, para exibir mais informações de ajuda sobre este cmdlet, inclua o parâmetro ‘Detailed’ conforme mostrado abaixo:
|_+_|Ao contrário de executar o comando acima sem o -Detalhado parâmetro, com este parâmetro, o comando retorna mais informações. Uma das informações agora incluídas é uma seção PARÂMETROS.
A seção PARÂMETROS lista e explica todos os parâmetros do Get-Command Cmdlet. Essas informações ajudam você a aprender mais sobre os parâmetros de um cmdlet e como usá-los.
Observe que no comando anterior, o parâmetro ‘Detailed’ não exigia nenhum valor de entrada. Este é outro exemplo de um parâmetro que não requer entrada. Lembre-se dos parâmetros 'switches' do tutorial 1 do PowerShell?Há ainda outro muito útil Obter ajuda parâmetro, ‘Full’. O parâmetro ‘Full’ exibe informações completas de ajuda sobre um cmdlet.
Além disso, as informações fornecidas pelo parâmetro 'Full' incluem aquelas fornecidas pelo parâmetro 'Detailed' e muito mais. Para ver o efeito do parâmetro ‘Full’, execute o comando abaixo:
|_+_|Para ajudá-lo a apreciar a diferença nas informações fornecidas pelo parâmetro 'Detalhado' em comparação com o parâmetro 'Full' - examine o primeiro parâmetro na seção PARÂMETRO (o Tudo parâmetro).
O resultado exibido à esquerda desta captura de tela é do comando Get-Help -Name Get-Command -Detailed. Pelo contrário, o resultado exibido no lado direito é do Get-Help -Name Get-Command – Completo comando.
Eu destaquei a diferença - os resultados do comando com o Completo parâmetro tem informações adicionais.
Seguindo em frente, o Obter ajuda O cmdlet tem mais dois parâmetros muito úteis: ‘Example’ e ‘Online’. O parâmetro ‘Example fornece exemplos sobre como usar um cmdlet.
Por outro lado, o parâmetro ‘Online’ leva você à página de ajuda online do cmdlet. Por exemplo, para iniciar a página de ajuda online para o Get-ChildItem cmdlet, execute o comando:
|_+_| O comando abrirá a página de ajuda em seu navegador padrão. Obviamente, você precisa de uma conexão com a Internet para exibir a página da web. A versão online das informações de ajuda dos Cmdlets é muito mais detalhada. Eu uso essas informações frequentemente quando estou criando scripts.Como usar o parâmetro 'Exemplos' do Get-Help
A página de ajuda dos cmdlets do PowerShell tem exemplos. Depois de revisar todas as outras seções, a seção EXEMPLOS mostrará maneiras de executar o cmdlet usando seus parâmetros.
Às vezes, você pode literalmente modificar esses exemplos para seus scripts. Por exemplo, para obter exemplos de como usar o Get-ChildItem Cmdlet, execute o comando abaixo:
|_+_|O comando acima exibe vários exemplos com os mesmos comandos com o Get-ChildItem Cmdlet.
Como atualizar as informações de ajuda do cmdlet com o comando Update-Help
As informações de ajuda do cmdlet armazenadas em seu computador podem se tornar obsoletas. Se você precisar atualizar essas informações, há um cmdlet que faz isso, Update-Help!
Parece um cmdlet? Sim, 'Atualizar' é o Verbo do cmdlet, enquanto 'Ajuda' é o Substantivo.
Como seria de esperar, o Atualizar-Ajuda O cmdlet também possui alguns parâmetros. No entanto, vamos ficar com o comando básico.
Para atualizar as informações de ajuda dos Cmdlets em seu computador, execute o comando abaixo:
|_+_|O comando levará algum tempo para ser concluído.
Referências e leitura adicional para o Tutorial 2 do PowerShell
Este tutorial é baseado no meu livro com o mesmo título. Você pode obtê-lo de Amazonas .
Espero que você tenha achado este Tutorial do PowerShell útil. Se achou útil, vote sim ao Este post foi útil? no final deste tutorial.
Alternativamente, se você deseja compartilhar suas ideias ou nos dar feedback sobre este tutorial, use o formulário DEIXE UMA RESPOSTA no final desta página.
Leia o tutorial 3 e 4 de 7
