Get-Help

Geeft informatie weer over PowerShell-opdrachten en -concepten.

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

De Get-Help cmdlet bevat informatie over PowerShell-concepten en -opdrachten, waaronder cmdlets, functies, CIM-opdrachten (Common Information Model), werkstromen, providers, aliassen en scripts.

Als u hulp wilt krijgen voor een PowerShell-cmdlet, typt u Get-Help gevolgd door de naam van de cmdlet, zoals: Get-Help Get-Process.

Conceptuele Help-artikelen in PowerShell beginnen met about_, zoals about_Comparison_Operators. Als u alle about_ artikelen wilt bekijken, typt u Get-Help about_*. Als u een bepaald artikel wilt zien, typt Get-Help about_<article-name>u, zoals Get-Help about_Comparison_Operators.

Als u hulp wilt krijgen voor een PowerShell-provider, typt u Get-Help gevolgd door de naam van de provider. Als u bijvoorbeeld hulp wilt krijgen voor de certificaatprovider, typt Get-Help Certificateu .

U kunt ook typen help of man, waarmee één scherm met tekst tegelijk wordt weergegeven. Of, <cmdlet-name> -?dat is identiek aan Get-Help, maar werkt alleen voor cmdlets.

Get-Help haalt de Help-inhoud op die wordt weergegeven uit Help-bestanden op uw computer. Zonder de Help-bestanden Get-Help worden alleen basisinformatie over cmdlets weergegeven. Sommige PowerShell-modules bevatten Help-bestanden. Vanaf PowerShell 3.0 bevatten de modules die worden geleverd met het Windows-besturingssysteem geen Help-bestanden. Gebruik de Update-Help cmdlet om de Help-bestanden voor een module in PowerShell 3.0 te downloaden of bij te werken.

U kunt ook de Help-documenten van PowerShell online bekijken. Als u de onlineversie van een Help-bestand wilt ophalen, gebruikt u de parameter Online , zoals: Get-Help Get-Process -Online.

Als u typt Get-Help gevolgd door de exacte naam van een Help-artikel of door een woord dat uniek is voor een Help-artikel, Get-Help wordt de inhoud van het artikel weergegeven. Als u de exacte naam van een opdrachtalias opgeeft, Get-Help wordt de Help voor de oorspronkelijke opdracht weergegeven. Als u een woord- of woordpatroon invoert dat in verschillende Help-artikeltitels wordt weergegeven, Get-Help wordt een lijst met de overeenkomende titels weergegeven. Als u tekst invoert die niet wordt weergegeven in help-artikeltitels, Get-Help wordt een lijst weergegeven met artikelen die die tekst in de inhoud bevatten.

Get-Help kan Help-artikelen krijgen voor alle ondersteunde talen en landinstellingen. Get-Help zoekt eerst naar Help-bestanden in de landinstelling voor Windows, vervolgens in de bovenliggende landinstelling, zoals pt voor pt-BR en vervolgens in een landinstelling voor terugval. Vanaf PowerShell 3.0, als Get-Help er geen help wordt gevonden in de landinstelling voor terugval, wordt gezocht naar Help-artikelen in het Engels, en-US, voordat er een foutbericht wordt geretourneerd of automatisch gegenereerde Help wordt weergegeven.

Zie about_Command_Syntax voor informatie over de symbolen die Get-Help worden weergegeven in het opdrachtsyntaxisdiagram. Zie about_Parameters voor informatie over parameterkenmerken, zoals Vereist en Positie.

Notitie

In PowerShell 3.0 en PowerShell 4.0 kunt u niet vinden over artikelen in modules, Get-Help tenzij de module in de huidige sessie wordt geïmporteerd. Als u over artikelen in een module wilt ophalen, importeert u de module met behulp van de Import-Module cmdlet of door een cmdlet uit te voeren die is opgenomen in de module.

Vanaf PSReadLine v2.2.2 wordt de module geleverd met twee functies die snelle toegang bieden om u te helpen terwijl u een opdracht op de opdrachtregel typt. De Help wordt weergegeven in de terminal in een alternatieve schermbuffer met pagine.

Wanneer u op de F1-toets drukt, wordt de functie PSReadLineShowCommandHelp aangeroepen Get-Help -Full voor de cmdlet-naam die zich het dichtst bij de linkerkant van de cursor bevindt. Wanneer de cursor direct links van een parameter staat, springt de functie naar de beschrijving van die parameter in het volledige Help-onderwerp. Wanneer u op Q drukt om de Help-weergave af te sluiten, keert u terug naar de opdrachtregel op dezelfde cursorpositie, zodat u de opdracht kunt blijven typen.

Wanneer u de toetsencombinatie Alt+h gebruikt, geeft de functie PSReadLineShowParameterHelp help-informatie weer voor de parameter direct links van de cursor. De Help-tekst wordt onder de opdrachtregel weergegeven. Hiermee kunt u de beschrijving van de parameter bekijken en doorgaan met het typen van uw opdracht.

Zie Dynamische Help gebruiken voor meer informatie.

Voorbeelden

Voorbeeld 1: Algemene Help-informatie over een cmdlet weergeven

In deze voorbeelden worden basisinformatie over help over de Format-Table cmdlet weergegeven.

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

Get-Help <cmdlet-name> is de eenvoudigste en standaardsyntaxis van Get-Help cmdlet. U kunt de parameter Name weglaten.

De syntaxis <cmdlet-name> -? werkt alleen voor cmdlets.

Voorbeeld 2: Basisinformatie één pagina tegelijk weergeven

In deze voorbeelden ziet u basisinformatie over help over de Format-Table cmdlet één pagina tegelijk.

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

help is een functie waarmee cmdlet intern wordt uitgevoerd Get-Help en het resultaat één pagina tegelijk wordt weergegeven.

man is een alias voor de help functie.

Get-Help Format-Table verzendt het object omlaag in de pijplijn. Out-Host -Paging ontvangt de uitvoer van de pijplijn en geeft deze één pagina tegelijk weer. Zie Out-Host voor meer informatie.

Voorbeeld 3: Meer informatie weergeven voor een cmdlet

In deze voorbeelden wordt gedetailleerdere help-informatie over de Format-Table cmdlet weergegeven.

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

Met de gedetailleerde parameter wordt de gedetailleerde weergave van het Help-artikel weergegeven met parameterbeschrijvingen en voorbeelden.

De parameter Volledig geeft de volledige weergave van het Help-artikel weer met parameterbeschrijvingen, voorbeelden, typen invoer- en uitvoerobjecten en aanvullende notities.

De parameters Gedetailleerd en Volledig zijn alleen van kracht voor de opdrachten waarop Help-bestanden op de computer zijn geïnstalleerd. De parameters zijn niet effectief voor de help-artikelen over conceptuele (about_).

Voorbeeld 4: Geselecteerde onderdelen van een cmdlet weergeven met behulp van parameters

In deze voorbeelden worden geselecteerde gedeelten van de Help van de Format-Table cmdlet weergegeven.

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

Met de parameter Voorbeelden worden de secties NAME en SYNOPSIS van het Help-bestand en alle voorbeelden weergegeven. U kunt geen voorbeeldnummer opgeven omdat de parameter Voorbeelden een schakelparameter is.

Met de parameter parameter worden alleen de beschrijvingen van de opgegeven parameters weergegeven. Als u alleen het jokerteken sterretje (*) opgeeft, worden de beschrijvingen van alle parameters weergegeven. Wanneer parameter een parameternaam zoals GroupBy opgeeft, wordt informatie over die parameter weergegeven.

Deze parameters zijn niet effectief voor de help-artikelen over conceptuele (about_).

Voorbeeld 5: Onlineversie van Help weergeven

In dit voorbeeld wordt de onlineversie van het Help-artikel voor de Format-Table cmdlet weergegeven in uw standaardwebbrowser.

Get-Help Format-Table -Online

Voorbeeld 6: Help weergeven over het Help-systeem

De Get-Help cmdlet zonder parameters geeft informatie weer over het PowerShell Help-systeem.

Get-Help

Voorbeeld 7: Beschikbare Help-artikelen weergeven

In dit voorbeeld wordt een lijst weergegeven met alle Help-artikelen die beschikbaar zijn op uw computer.

Get-Help *

Voorbeeld 8: Een lijst met conceptuele artikelen weergeven

In dit voorbeeld wordt een lijst weergegeven met de conceptuele artikelen die zijn opgenomen in PowerShell Help. Al deze artikelen beginnen met de tekens about_. Als u een bepaald Help-bestand wilt weergeven, typt Get-Help \<about_article-name\>u bijvoorbeeld Get-Help about_Signing.

Alleen de conceptuele artikelen met Help-bestanden die op uw computer zijn geïnstalleerd, worden weergegeven. Zie Update-Help voor informatie over het downloaden en installeren van Help-bestanden in PowerShell 3.0.

Get-Help about_*

Voorbeeld 9: Zoeken naar een woord in de Help voor cmdlets

In dit voorbeeld ziet u hoe u kunt zoeken naar een woord in een Help-artikel over cmdlets.

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 gebruikt de parameter Volledig om help-informatie voor Add-Memberte krijgen. Het MamlCommandHelpInfo-object wordt via de pijplijn verzonden. Out-Stringgebruikt de Stream-parameter om het object te converteren naar een tekenreeks. Select-String gebruikt de parameter Pattern om de tekenreeks voor Clixml te doorzoeken.

Voorbeeld 10: Een lijst met artikelen weergeven die een woord bevatten

In dit voorbeeld wordt een lijst weergegeven met artikelen met het woord voor externe communicatie.

Wanneer u een woord invoert dat niet in een artikeltitel wordt weergegeven, Get-Help wordt een lijst weergegeven met artikelen die dat woord bevatten.

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

Voorbeeld 11: Specifieke help voor de provider weergeven

In dit voorbeeld ziet u twee manieren om de providerspecifieke hulp voor Get-Itemte krijgen. Deze opdrachten krijgen hulp bij het gebruik van de Get-Item cmdlet in het DataCollection-knooppunt van de PowerShell SQL Server-provider.

In het eerste voorbeeld wordt de Get-Helppadparameter gebruikt om het pad van de SQL Server-provider op te geven. Omdat het pad van de provider is opgegeven, kunt u de opdracht uitvoeren vanaf elke padlocatie.

In het tweede voorbeeld wordt gebruikgemaakt Set-Location van het navigeren naar het pad van de SQL Server-provider. Vanaf die locatie is de padparameter niet nodig om Get-Help de providerspecifieke hulp te krijgen.

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

Voorbeeld 12: Help voor een script weergeven

In dit voorbeeld krijgt u hulp voor de MyScript.ps1 script. Zie about_Comment_Based_Help voor informatie over het schrijven van help voor uw functies en scripts.

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

Parameters

-Category

Geeft alleen help weer voor items in de opgegeven categorie en de bijbehorende aliassen. Conceptuele artikelen bevinden zich in de categorie HelpFile .

De acceptabele waarden voor deze parameter zijn als volgt:

  • Alias
  • Cmdlet
  • Provider
  • Algemeen
  • Veelgestelde vragen
  • Woordenlijst
  • Helpfile
  • ScriptOpdracht
  • Functie
  • Filter
  • ExternalScript
  • Alle
  • DefaultHelp
  • Workflow
  • DscResource
  • Klas
  • Configuratie
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

Geeft opdrachten weer met de opgegeven onderdeelwaarde, zoals Exchange. Voer een onderdeelnaam in. Jokertekens zijn toegestaan. Deze parameter heeft geen effect op weergaven van conceptuele hulp (About_).

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Detailed

Voegt parameterbeschrijvingen en voorbeelden toe aan de weergave basishulp. Deze parameter is alleen van kracht wanneer de Help-bestanden op de computer zijn geïnstalleerd. Het heeft geen effect op weergaven van conceptuele hulp (About_).

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Examples

Geeft alleen de naam, synopsis en voorbeelden weer. Deze parameter is alleen van kracht wanneer de Help-bestanden op de computer zijn geïnstalleerd. Het heeft geen effect op weergaven van conceptuele hulp (About_).

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Full

Hiermee wordt het hele Help-artikel voor een cmdlet weergegeven. Volledig bevat parameterbeschrijvingen en kenmerken, voorbeelden, typen invoer- en uitvoerobjecten en aanvullende notities.

Deze parameter is alleen van kracht wanneer de Help-bestanden op de computer zijn geïnstalleerd. Het heeft geen effect op weergaven van conceptuele hulp (About_).

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Functionality

Geeft help weer voor items met de opgegeven functionaliteit. Voer de functionaliteit in. Jokertekens zijn toegestaan. Deze parameter heeft geen effect op weergaven van conceptuele hulp (About_).

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

Hiermee krijgt u hulp over de opgegeven opdracht of het opgegeven concept. Voer de naam in van een cmdlet, functie, provider, script of werkstroom, zoals Get-Membereen conceptuele artikelnaam, zoals about_Objectsof een alias, zoals ls. Jokertekens zijn toegestaan in cmdlet- en providernamen, maar u kunt geen jokertekens gebruiken om de namen van help- en script-help-artikelen te vinden.

Als u hulp wilt krijgen voor een script dat zich niet in een pad bevindt dat wordt vermeld in de $env:Path omgevingsvariabele, typt u het pad en de bestandsnaam van het script.

Als u de exacte naam van een Help-artikel invoert, Get-Help wordt de inhoud van het artikel weergegeven.

Als u een woord- of woordpatroon invoert dat in verschillende Help-artikeltitels wordt weergegeven, Get-Help wordt een lijst met de overeenkomende titels weergegeven.

Als u tekst invoert die niet overeenkomt met help-artikeltitels, Get-Help wordt een lijst weergegeven met artikelen met die tekst in de inhoud.

De namen van conceptuele artikelen, zoals about_Objects, moeten worden ingevoerd in het Engels, zelfs in niet-Engelse versies van PowerShell.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Online

Geeft de onlineversie van een Help-artikel weer in de standaardbrowser. Deze parameter is alleen geldig voor help-artikelen over cmdlets, functies, werkstromen en scripts. U kunt de parameter Get-Help Online niet gebruiken in een externe sessie.

Zie about_Comment_Based_Help en Ondersteunende Online Help voor PowerShell-cmdlets voor informatie over het ondersteunen van deze functie in Help-artikelen die u schrijft.

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Parameter

Geeft alleen de gedetailleerde beschrijvingen van de opgegeven parameters weer. Jokertekens zijn toegestaan. Deze parameter heeft geen effect op weergaven van conceptuele hulp (About_).

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Path

Hiermee wordt uitgelegd hoe de cmdlet werkt in het opgegeven providerpad. Voer een PowerShell-providerpad in.

Met deze parameter wordt een aangepaste versie van een Help-artikel voor cmdlets opgehaald waarin wordt uitgelegd hoe de cmdlet werkt in het opgegeven PowerShell-providerpad. Deze parameter is alleen van kracht voor hulp bij een provider-cmdlet en alleen wanneer de provider een aangepaste versie van het Help-artikel van de provider-cmdlet in het Help-bestand bevat. Als u deze parameter wilt gebruiken, installeert u het Help-bestand voor de module die de provider bevat.

Als u de help voor aangepaste cmdlets voor een providerpad wilt bekijken, gaat u naar de locatie van het providerpad en voert u een Get-Help opdracht in of gebruikt u de padparameter Path om Get-Help het pad van de provider op te geven. U kunt ook online aangepaste help voor cmdlets vinden in de helpsectie van de provider van de Help-artikelen.

Zie about_Providers voor meer informatie over PowerShell-providers.

Notitie

De provider voor het opgegeven pad moet een Help-bestand van de PowerShell-provider hebben geïnstalleerd. Als er geen helpbestand van de provider beschikbaar is, wordt er geen help-informatie geretourneerd. Er zijn geen helpbestanden van providers beschikbaar voor de providers die zijn opgenomen in deze versie van PowerShell.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Role

Geeft help weer die is aangepast voor de opgegeven gebruikersrol. Voer een rol in. Jokertekens zijn toegestaan.

Voer de rol in die de gebruiker speelt in een organisatie. Sommige cmdlets geven verschillende tekst weer in hun Help-bestanden op basis van de waarde van deze parameter. Deze parameter heeft geen effect op help voor de kern-cmdlets.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ShowWindow

Hiermee wordt het Help-onderwerp weergegeven in een venster voor eenvoudiger lezen. Het venster bevat een zoekfunctie zoeken en een Instellingen vak waarmee u opties voor de weergave kunt instellen, inclusief opties om alleen geselecteerde secties van een Help-onderwerp weer te geven.

De parameter ShowWindow ondersteunt Help-onderwerpen voor opdrachten (cmdlets, functies, CIM-opdrachten, scripts) en conceptuele artikelen over. Het biedt geen ondersteuning voor providerondersteuning.

Deze parameter is opnieuw geïntroduceerd in PowerShell 7.0. Deze parameter is alleen beschikbaar in Windows.

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

ExtendedCmdletHelpInfo

Als u Get-Help een opdracht uitvoert die geen Help-bestand heeft, Get-Help retourneert u een ExtendedCmdletHelpInfo-object dat automatisch gegenereerde Help vertegenwoordigt.

String

Als u een conceptueel Help-artikel krijgt, Get-Help wordt dit geretourneerd als een tekenreeks.

MamlCommandHelpInfo

Als u een opdracht met een Help-bestand krijgt, Get-Help retourneert u een MamlCommandHelpInfo-object .

Notities

PowerShell 3.0 bevat geen Help-bestanden. Gebruik de Update-Help cmdlet om de Help-bestanden te downloaden en te installeren die worden Get-Help gelezen. U kunt de Update-Help cmdlet gebruiken om Help-bestanden te downloaden en te installeren voor de kernopdrachten die bij PowerShell worden geleverd en voor alle modules die u installeert. U kunt deze ook gebruiken om de Help-bestanden bij te werken, zodat de help op uw computer nooit verouderd is.

U kunt ook de Help-artikelen lezen over de opdrachten die online bij PowerShell worden geleverd vanaf Aan de slag met Windows PowerShell.

Get-Help geeft help weer in de landinstelling die is ingesteld voor het Windows-besturingssysteem of in de terugvaltaal voor die landinstelling. Als u geen Help-bestanden voor de primaire of terugvallocatie hebt, Get-Help gedraagt u zich alsof er geen Help-bestanden op de computer zijn. Als u hulp wilt krijgen bij een andere landinstelling, gebruikt u Regio en Taal in Configuratiescherm om de instellingen te wijzigen. In Windows 10 of hoger, Instellingen, Time & Language.

De volledige weergave van help bevat een tabel met informatie over de parameters. De tabel bevat de volgende velden:

  • Vereist. Geeft aan of de parameter vereist is (waar) of optioneel (onwaar).

  • Positie. Geeft aan of de parameter een naam heeft of positioneel (numeriek). Positionele parameters moeten worden weergegeven op een opgegeven plaats in de opdracht.

  • Benoemd geeft aan dat de parameternaam vereist is, maar dat de parameter overal in de opdracht kan worden weergegeven.

  • Numeriek geeft aan dat de parameternaam optioneel is, maar wanneer de naam wordt weggelaten, moet de parameter op de plaats staan die is opgegeven door het getal. Geeft bijvoorbeeld 2 aan dat wanneer de parameternaam wordt weggelaten, de parameter de tweede of alleen naamloze parameter in de opdracht moet zijn. Wanneer de parameternaam wordt gebruikt, kan de parameter overal in de opdracht worden weergegeven.

  • Standaardwaarde. De parameterwaarde of het standaardgedrag dat PowerShell gebruikt als u de parameter niet in de opdracht opneemt.

  • Accepteert pijplijninvoer. Hiermee wordt aangegeven of u objecten via een pijplijn naar de parameter kunt verzenden (waar) of niet (onwaar). Met eigenschapsnaam moet het pijplijnobject een eigenschap hebben die dezelfde naam heeft als de parameternaam.

  • Accepteert jokertekens. Hiermee wordt aangegeven of de waarde van een parameter jokertekens kan bevatten, zoals een sterretje (*) of vraagteken (?).