Get-Help

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

Cmdleten Get-Help visar information om PowerShell-begrepp och -kommandon, inklusive cmdletar, funktioner, CIM-kommandon (Common Information Model), arbetsflöden, leverantörer, alias och skript.

Om du vill få hjälp med en PowerShell-cmdlet skriver du Get-Help följt av cmdletnamnet, till exempel: Get-Help Get-Process.

Konceptuella hjälpartiklar i PowerShell börjar med about_, till exempel about_Comparison_Operators. Om du vill se alla about_ artiklar skriver du Get-Help about_*. Om du vill se en viss artikel skriver du Get-Help about_<article-name>, till exempel Get-Help about_Comparison_Operators.

Om du vill få hjälp för en PowerShell-provider skriver du Get-Help följt av providernamnet. Om du till exempel vill få hjälp med certifikatprovidern skriver du Get-Help Certificate.

Du kan också skriva help eller man, som visar en skärm med text i taget. Eller , <cmdlet-name> -?det är identiskt med Get-Help, men fungerar bara för cmdletar.

Get-Help hämtar hjälpinnehållet som visas från hjälpfiler på datorn. Utan hjälpfilerna Get-Help visas endast grundläggande information om cmdletar. Vissa PowerShell-moduler innehåller hjälpfiler. Från och med PowerShell 3.0 innehåller de moduler som medföljer Windows-operativsystemet inte hjälpfiler. Om du vill ladda ned eller uppdatera hjälpfilerna för en modul i PowerShell 3.0 använder du cmdleten Update-Help .

Du kan också visa PowerShell-hjälpdokumenten online. Om du vill hämta onlineversionen av en hjälpfil använder du parametern Online , till exempel: Get-Help Get-Process -Online.

Om du skriver Get-Help följt av det exakta namnet på en hjälpartikel, eller med ett ord som är unikt för en hjälpartikel, Get-Help visas artikelns innehåll. Om du anger det exakta namnet på ett kommandoalias Get-Help visas hjälpen för det ursprungliga kommandot. Om du anger ett ord- eller ordmönster som visas i flera rubriker i hjälpartikeln Get-Help visar du en lista över matchande rubriker. Om du anger text som inte visas i någon hjälpartikel Get-Help visas en lista med artiklar som innehåller texten i innehållet.

Get-Help kan få hjälpartiklar för alla språk och nationella inställningar som stöds. Get-Help söker först efter hjälpfiler i nationella inställningar för Windows, sedan i det överordnade språket, till exempel pt för pt-BR, och sedan i ett återställningsspråk. Från och med PowerShell 3.0 letar Get-Help den efter hjälpartiklar på engelska, en-US, innan det returnerar ett felmeddelande eller visar automatiskt genererad hjälp.

Information om de symboler som Get-Help visas i kommandosyntaxdiagrammet finns i about_Command_Syntax. Information om parameterattribut, till exempel Obligatoriskt och Position, finns i about_Parameters.

Från och med PSReadLine v2.2.2 levereras modulen med två funktioner som ger snabb åtkomst till hjälp när du skriver ett kommando på kommandoraden. Hjälpen visas i terminalen i en alternativ skärmbuffert med växling.

När du trycker på F1-tangenten anropar Get-Help -Full funktionen PSReadLine ShowCommandHelp för cmdlet-namnet närmast till vänster om markören. När markören är omedelbart till vänster om en parameter, hoppar funktionen till parameterns beskrivning i det fullständiga hjälpavsnittet. När du trycker på Q för att avsluta hjälpvyn, returneras du till kommandoraden i samma markörposition så att du kan fortsätta skriva kommandot.

När du använder tangentkombinationen Alt+h visar funktionen PSReadLine ShowParameterHelp hjälpinformation för parametern direkt till vänster om markören. Hjälptexten visas under kommandoraden. På så sätt kan du se beskrivningen av parametern och fortsätta skriva kommandot.

Mer information finns i Använda dynamisk hjälp.

Exempel

Exempel 1: Visa grundläggande hjälpinformation om en cmdlet

De här exemplen visar grundläggande hjälpinformation om cmdleten Format-Table .

Get-Help Format-Table
Get-Help -Name Format-Table
Format-Table -?

Get-Help <cmdlet-name> är den enklaste och standardsyntaxen för Get-Help cmdlet. Du kan utelämna parametern Namn .

Syntaxen <cmdlet-name> -? fungerar endast för cmdletar.

Exempel 2: Visa grundläggande information en sida i taget

De här exemplen visar grundläggande hjälpinformation om cmdleten Format-Table en sida i taget.

help Format-Table
man Format-Table
Get-Help Format-Table | Out-Host -Paging

help är en funktion som kör Get-Help cmdleten internt och visar resultatet en sida i taget.

man är ett alias för help funktionen.

Get-Help Format-Table skickar objektet nedåt i pipelinen. Out-Host -Paging tar emot utdata från pipelinen och visar den en sida i taget. Mer information finns i Out-Host.

Exempel 3: Visa mer information för en cmdlet

De här exemplen visar mer detaljerad hjälpinformation om cmdleten Format-Table .

Get-Help Format-Table -Detailed
Get-Help Format-Table -Full

Parametern Detaljerad visar hjälpartikelns detaljerade vy som innehåller parameterbeskrivningar och exempel.

Den fullständiga parametern visar hjälpartikelns fullständiga vy som innehåller parameterbeskrivningar, exempel, indata- och utdataobjekttyper och ytterligare anteckningar.

De detaljerade och fullständiga parametrarna gäller endast för de kommandon som har hjälpfiler installerade på datorn. Parametrarna är inte effektiva för de konceptuella (about_) hjälpartiklarna.

Exempel 4: Visa valda delar av en cmdlet med hjälp av parametrar

De här exemplen visar valda delar av cmdlet-hjälpen Format-Table .

Get-Help Format-Table -Examples
Get-Help Format-Table -Parameter *
Get-Help Format-Table -Parameter GroupBy

Parametern Exempel visar hjälpfilens namn - och SYNOPSIS-avsnitt och alla exempel. Du kan inte ange ett exempelnummer eftersom parametern Examples är en växelparameter.

Parameterparametern visar endast beskrivningarna av de angivna parametrarna. Om du bara anger jokertecknet asterisk (*) visas beskrivningarna av alla parametrar. När Parameter anger ett parameternamn, till exempel GroupBy, visas information om parametern.

Dessa parametrar är inte effektiva för de konceptuella (about_) hjälpartiklarna.

Exempel 5: Visa onlineversion av hjälp

I det här exemplet visas onlineversionen av hjälpartikeln för cmdleten Format-Table i standardwebbläsaren.

Get-Help Format-Table -Online

Exempel 6: Visa hjälp om hjälpsystemet

Cmdleten Get-Help utan parametrar visar information om PowerShell-hjälpsystemet.

Get-Help

Exempel 7: Visa tillgängliga hjälpartiklar

I det här exemplet visas en lista över alla hjälpartiklar som är tillgängliga på datorn.

Get-Help *

Exempel 8: Visa en lista över konceptuella artiklar

I det här exemplet visas en lista över de konceptuella artiklar som ingår i PowerShell-hjälpen. Alla dessa artiklar börjar med tecknen about_. Om du vill visa en viss hjälpfil skriver du Get-Help \<about_article-name\>, till exempel Get-Help about_Signing.

Endast de konceptuella artiklar som har hjälpfiler installerade på datorn visas. Information om hur du laddar ned och installerar hjälpfiler i PowerShell 3.0 finns i Uppdateringshjälp.

Get-Help about_*

Exempel 9: Sök efter ett ord i cmdlet-hjälpen

Det här exemplet visar hur du söker efter ett ord i en cmdlet-hjälpartikel.

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 använder parametern Fullständig för att få hjälpinformation för Add-Member. MamlCommandHelpInfo-objektet skickas ned i pipelinen. Out-Stringanvänder Stream-parametern för att konvertera objektet till en sträng. Select-Stringanvänder parametern Pattern för att söka efter Clixml i strängen.

Exempel 10: Visa en lista med artiklar som innehåller ett ord

I det här exemplet visas en lista med artiklar som innehåller ordet fjärrkommunikation.

När du anger ett ord som inte visas i någon artikelrubrik Get-Help visas en lista med artiklar som innehåller det ordet.

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...

Exempel 11: Visa providerspecifik hjälp

Det här exemplet visar två sätt att få den providerspecifika hjälpen för Get-Item. Dessa kommandon får hjälp som förklarar hur du använder cmdleten Get-Item i PowerShell SQL Server-providerns DataCollection-nod .

I det första exemplet används parametern Get-Help Path för att ange SQL Server-providerns sökväg. Eftersom providerns sökväg har angetts kan du köra kommandot från valfri sökvägsplats.

Det andra exemplet används Set-Location för att navigera till SQL Server-providerns sökväg. Från den platsen behövs inte sökvägsparametern för Get-Help att få den providerspecifika hjälpen.

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.
    ...

Exempel 12: Visa hjälp för ett skript

Det här exemplet får hjälp för MyScript.ps1 script. Information om hur du skriver hjälp för dina funktioner och skript finns i about_Comment_Based_Help.

Get-Help -Name C:\PS-Test\MyScript.ps1

Parametrar

-Category

-Component

-Detailed

-Examples

-Full

-Functionality

-Name

-Online

-Parameter

-Path

-Role

-ShowWindow

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

ExtendedCmdletHelpInfo

Om du kör Get-Help ett kommando som inte har någon hjälpfil Get-Help returnerar du ett ExtendedCmdletHelpInfo-objekt som representerar autogenererad hjälp.

String

Om du får en konceptuell hjälpartikel Get-Help returneras den som en sträng.

MamlCommandHelpInfo

Om du får ett kommando som har en hjälpfil Get-Help returnerar ett MamlCommandHelpInfo-objekt .

Kommentarer

PowerShell 3.0 innehåller inte hjälpfiler. Om du vill ladda ned och installera hjälpfilerna som Get-Help läser använder du cmdleten Update-Help . Du kan använda cmdleten Update-Help för att ladda ned och installera hjälpfiler för de kärnkommandon som medföljer PowerShell och för alla moduler som du installerar. Du kan också använda den för att uppdatera hjälpfilerna så att hjälpen på datorn aldrig är inaktuell.

Du kan också läsa hjälpartiklarna om kommandona som medföljer PowerShell online från Komma igång med Windows PowerShell.

Get-Help visar hjälp i nationella inställningar för Windows-operativsystemet eller på återställningsspråket för det språket. Om du inte har hjälpfiler för det primära språket eller återställningsspråket Get-Help fungerar det som om det inte finns några hjälpfiler på datorn. Om du vill få hjälp med ett annat språk använder du Region och Språk i Kontrolna tabla för att ändra inställningarna. I Windows 10 eller senare, Inställningar, Tid och språk.

Den fullständiga vyn av hjälpen innehåller en tabell med information om parametrarna. Tabellen innehåller följande fält:

• Obligatoriska. Anger om parametern krävs (sant) eller valfritt (falskt).

• Position. Anger om parametern heter eller är positionell (numerisk). Positionsparametrar måste visas på en angiven plats i kommandot.

• Namngivet anger att parameternamnet krävs, men att parametern kan visas var som helst i kommandot.

• Numeriskt anger att parameternamnet är valfritt, men när namnet utelämnas måste parametern finnas på den plats som anges av talet. Anger till exempel 2 att när parameternamnet utelämnas måste parametern vara den andra eller enda namnlösa parametern i kommandot. När parameternamnet används kan parametern visas var som helst i kommandot.

• Standardvärde. Parametervärdet eller standardbeteendet som PowerShell använder om du inte inkluderar parametern i kommandot.

• Accepterar pipelineindata. Anger om du kan (sant) eller inte kan (falskt) skicka objekt till parametern via en pipeline. Med Egenskapsnamn innebär det att det pipelinerade objektet måste ha en egenskap som har samma namn som parameternamnet.

• Accepterar jokertecken. Anger om värdet för en parameter kan innehålla jokertecken, till exempel en asterisk (*) eller frågetecken (?).

Relaterade länkar

• about_Command_Syntax
• about_Comment_Based_Help
• Get-Command
• Stöd för uppdateringsbar hjälp
• Update-Help
• Skriva kommentarsbaserade hjälpavsnitt
• Skriva hjälp för PowerShell-cmdletar