Godkända verb för PowerShell-kommandon

  • Artikel

PowerShell använder ett verb-substantivpar för namnen på cmdletarna och för deras härledda .NET-klasser. Verbdelen av namnet identifierar den åtgärd som cmdleten utför. Substantivdelen av namnet identifierar den entitet som åtgärden utförs på. Cmdleten Get-Command hämtar till exempel alla kommandon som är registrerade i PowerShell.

Anteckning

PowerShell använder termen verb för att beskriva ett ord som innebär en åtgärd även om ordet inte är ett standardverb på engelska. Termen Nytt är till exempel ett giltigt PowerShell-verbnamn eftersom det antyder en åtgärd även om det inte är ett verb på engelska.

Varje godkänt verb har ett definierat motsvarande aliasprefix . Vi använder det här aliasprefixet i alias för kommandon som använder det verbet. Till exempel är aliasprefixet Import för ip och därför är aliaset för Import-Module ipmo. Det här är en rekommendation, men inte en regel. I synnerhet behöver den inte respekteras för kommandoalias som imiterar välkända kommandon från andra miljöer.

Namn på verb Rekommendationer

Följande rekommendationer hjälper dig att välja ett lämpligt verb för cmdleten för att säkerställa konsekvens mellan de cmdlets som du skapar, de cmdlets som tillhandahålls av PowerShell och de cmdlets som har utformats av andra.

  • Använd ett av de fördefinierade verbnamnen som tillhandahålls av PowerShell
  • Använd verbet för att beskriva åtgärdens allmänna omfattning och använd parametrar för att ytterligare förfina cmdletens åtgärd.
  • Använd inte en synonym till ett godkänt verb. Använd till exempel alltid Remove, använd aldrig Delete eller Eliminate.
  • Använd endast formen för varje verb som listas i det här avsnittet. Använd till exempel Get, men använd inte Getting eller Gets.
  • Använd inte följande reserverade verb eller alias. PowerShell-språket och några få cmdlets använder dessa verb under särskilda omständigheter.
    • ForEach (foreach)
    • Ping (pi)
    • Sortera (sr)
    • – (te)
    • Var (vad)

Du kan få en fullständig lista över verb med hjälp av Get-Verb cmdleten .

Liknande verb för olika åtgärder

Följande liknande verb representerar olika åtgärder.

Ny jämfört med Lägg till

Använd verbet New för att skapa en ny resurs. Använd för Add att lägga till något i en befintlig container eller resurs. Lägger till exempel Add-Content till utdata till en befintlig fil.

Ny jämfört med Set

Använd verbet New för att skapa en ny resurs. Set Använd verbet för att ändra en befintlig resurs. Du kan också skapa den om den inte finns, till exempel Set-Variable cmdleten .

Find Använd verbet för att leta efter ett -objekt. Använd verbet Search för att skapa en referens till en resurs i en container.

Hämta jämfört med Läsa

Get Använd verbet för att hämta information om en resurs (till exempel en fil) eller för att hämta ett objekt som du kan komma åt resursen med i framtiden. Använd verbet Read för att öppna en resurs och extrahera information som finns i den.

Anropa jämfört med Starta

Invoke Använd verbet för att utföra synkrona åtgärder, till exempel köra ett kommando och vänta på att det ska avslutas. Start Använd verbet för att starta asynkrona åtgärder, till exempel starta en autonom process.

Ping jämfört med test

Test Använd verbet .

Vanliga verb

PowerShell använder klassen System.Management.Automation.VerbsCommon-uppräkning för att definiera allmänna åtgärder som kan tillämpas på nästan vilken cmdlet som helst. I följande tabell visas de flesta av de definierade verben.

Verb (alias) Åtgärd Synonymer att undvika
Lägg till (a) Lägger till en resurs i en container eller kopplar ett objekt till ett annat objekt. Cmdleten lägger Add-Content till exempel till innehåll i en fil. Det här verbet är kopplat till Remove. Append, Attach, Concatenate, Insert
Rensa (cl) Tar bort alla resurser från en container men tar inte bort containern. Till exempel tar Clear-Content cmdleten bort innehållet i en fil men tar inte bort filen. Flush, Erase, Release, Unmark, Unset, Nullify
Stäng (cs) Ändrar tillståndet för en resurs för att göra den otillgänglig, otillgänglig eller oanvändbar. Det här verbet är kopplat till Open.
Kopiera (cp) Kopierar en resurs till ett annat namn eller till en annan container. Cmdleten Copy-Item kopierar till exempel ett objekt (till exempel en fil) från en plats i datalagret till en annan plats. Duplicera, klona, replikera, synkronisera
Ange (et) Anger en åtgärd som gör att användaren kan flytta till en resurs. Till exempel placerar Enter-PSSession cmdleten användaren i en interaktiv session. Det här verbet är kopplat till Exit. Push-skicka, till
Avsluta (t.ex.) Anger den aktuella miljön eller kontexten till den senast använda kontexten. Till exempel placerar Exit-PSSession cmdleten användaren i den session som användes för att starta den interaktiva sessionen. Det här verbet är kopplat till Enter. Pop, Out
Hitta (fd) Söker efter ett objekt i en container som är okänd, underförstådd, valfri eller angiven. Sök
Format (f) Ordnar objekt i ett angivet formulär eller en angiven layout
Hämta (g) Anger en åtgärd som hämtar en resurs. Det här verbet är kopplat till Set. Read, Open, Cat, Type, Dir, Obtain, Dump, Acquire, Examine, Find, Search
Dölj (h) Gör en resurs oidentifierbar. En cmdlet vars namn innehåller verbet Dölj kan till exempel ta bort en tjänst från en användare. Det här verbet är kopplat till Show. Blockera
Ansluta (j) Kombinerar resurser till en resurs. Cmdleten kombinerar Join-Path till exempel en sökväg med en av dess underordnade sökvägar för att skapa en enda sökväg. Det här verbet är kopplat till Split. Kombinera, Förena, Anslut, Associera
Lås (lk) Skyddar en resurs. Det här verbet är kopplat till Unlock. Begränsa, skydda
Flytta (m) Flyttar en resurs från en plats till en annan. Till exempel flyttar Move-Item cmdleten ett objekt från en plats i datalagret till en annan plats. Överföring, Namn, Migrera
Ny (n) Skapar en resurs. (Verbet Set kan också användas när du skapar en resurs som innehåller data, till exempel Set-Variable cmdleten.) Skapa, generera, skapa, göra, allokera
Öppna (op) Ändrar tillståndet för en resurs så att den blir tillgänglig, tillgänglig eller användbar. Det här verbet är kopplat till Close.
Optimera (om) Ökar effektiviteten för en resurs.
Pop (pop) Tar bort ett objekt överst i en stack. Till exempel ändrar Pop-Location cmdleten den aktuella platsen till den plats som senast pushades till stacken.
Push-push (pu) Lägger till ett objekt överst i en stack. Cmdleten Push-Location pushar till exempel den aktuella platsen till stacken.
Gör om (om) Återställer en resurs till det tillstånd som ångrades.
Ta bort (r) Tar bort en resurs från en container. Till exempel tar Remove-Variable cmdleten bort en variabel och dess värde. Det här verbet är kopplat till Add. Rensa, Klipp ut, Ta bort, Ta bort, Radera
Byt namn (rn) Ändrar namnet på en resurs. Till exempel ändrar Rename-Item cmdleten, som används för att komma åt lagrade data, namnet på ett objekt i datalagret. Ändra
Återställ (rs) Anger en resurs tillbaka till dess ursprungliga tillstånd.
Ändra storlek (rz) Ändrar storleken på en resurs.
Sök (sr) Skapar en referens till en resurs i en container. Hitta, hitta
Välj (sc) Letar upp en resurs i en container. Cmdleten Select-String hittar till exempel text i strängar och filer. Hitta, hitta
Ange (s) Ersätter data på en befintlig resurs eller skapar en resurs som innehåller vissa data. Till exempel ändrar Set-Date cmdleten systemtiden på den lokala datorn. (Verbet New kan också användas för att skapa en resurs.) Det här verbet är kopplat till Get. Skriva, återställa, tilldela, konfigurera
Visa (sh) Gör en resurs synlig för användaren. Det här verbet är kopplat till Hide. Visa, producera
Hoppa över (sk) Kringgår en eller flera resurser eller punkter i en sekvens. Kringgå, hoppa
Dela (sl) Separerar delar av en resurs. Till exempel returnerar Split-Path cmdleten olika delar av en sökväg. Det här verbet är kopplat till Join. Separat
Steg (st) Flyttar till nästa punkt eller resurs i en sekvens.
Växla (sw) Anger en åtgärd som växlar mellan två resurser, till exempel för att ändra mellan två platser, ansvarsområden eller tillstånd.
Ångra (av) Anger en resurs till dess tidigare tillstånd.
Lås upp (storbritannien) Släpper en resurs som har låsts. Det här verbet är kopplat till Lock. Release, Unrestrict, Unsecure
Titta (wc) Inspekterar eller övervakar kontinuerligt en resurs för ändringar.

Kommunikationsverb

PowerShell använder klassen System.Management.Automation.VerbsCommunications för att definiera åtgärder som gäller för kommunikation. I följande tabell visas de flesta av de definierade verben.

Verb (alias) Åtgärd Synonymer att undvika
Anslut (cc) Skapar en länk mellan en källa och ett mål. Det här verbet är kopplat till Disconnect. Anslut till Telnet
Koppla från (dc) Bryter länken mellan en källa och ett mål. Det här verbet är kopplat till Connect. Break, Logoff
Läsa (rd) Hämtar information från en källa. Det här verbet är kopplat till Write. Hämta, fråga, hämta
Ta emot (rc) Godkänner information som skickas från en källa. Det här verbet är kopplat till Send. Läsa, acceptera, granska
Skicka (sd) Levererar information till ett mål. Det här verbet är kopplat till Receive. Put, Broadcast, Mail, Fax
Skriva (wr) Lägger till information i ett mål. Det här verbet är kopplat till Read. Placera, skriv ut

Dataverb

PowerShell använder klassen System.Management.Automation.VerbsData för att definiera åtgärder som gäller för datahantering. I följande tabell visas de flesta av de definierade verben.

Verbnamn (alias) Åtgärd Synonymer att undvika
Säkerhetskopiering (ba) Lagrar data genom att replikera dem. Spara, burn, replikera, synkronisera
Kontrollpunkt (ch) Skapar en ögonblicksbild av det aktuella tillståndet för data eller dess konfiguration. Diff
Jämför (cr) Utvärderar data från en resurs mot data från en annan resurs. Diff
Komprimera (cm) Komprimerar data för en resurs. Parkopplas med Expand. Kompakt
Konvertera (cv) Ändrar data från en representation till en annan när cmdleten stöder dubbelriktad konvertering eller när cmdleten stöder konvertering mellan flera datatyper. Ändra, ändra storlek, omsampling
ConvertFrom (cf) Konverterar en primär typ av indata (cmdlet-substantivet anger indata) till en eller flera utdatatyper som stöds. Exportera, utdata, ut
ConvertTo (ct) Konverterar från en eller flera typer av indata till en primär utdatatyp (cmdlet-substantivet anger utdatatypen). Import, Input, In
Demontera (dm) Tar bort en namngiven entitet från en plats. Det här verbet är kopplat till Mount. Demontera, ta bort länk
Redigera (ed) Ändrar befintliga data genom att lägga till eller ta bort innehåll. Ändra, uppdatera, ändra
Expandera (en) Återställer data för en resurs som har komprimerats till dess ursprungliga tillstånd. Det här verbet är kopplat till Compress. Uttryck, okomprimering
Exportera (ep) Kapslar in primära indata i ett beständigt datalager, till exempel en fil eller i ett utbytesformat. Det här verbet är kopplat till Import. Extrahera, säkerhetskopiera
Grupp (gp) Ordnar eller associerar en eller flera resurser
Importera (ip) Skapar en resurs från data som lagras i ett beständigt datalager (till exempel en fil) eller i ett utbytesformat. Till exempel importerar Import-CSV cmdleten data från en fil med kommaavgränsade värden (CSV) till objekt som kan användas av andra cmdlets. Det här verbet är kopplat till Export. BulkLoad, Load
Initiera (i) Förbereder en resurs för användning och anger den till ett standardtillstånd. Radera, init, förnya, återskapa, initiera om, konfigurera
Gräns (l) Tillämpar begränsningar för en resurs. Kvot
Sammanfoga (mg) Skapar en enskild resurs från flera resurser. Kombinera, anslut
Montering (mt) Bifogar en namngiven entitet till en plats. Det här verbet är kopplat till Dismount. Anslut
Ut (o) Skickar data från miljön. Till exempel skickar Out-Printer cmdleten data till en skrivare.
Publicera (pb) Gör en resurs tillgänglig för andra. Det här verbet är kopplat till Unpublish. Distribuera, släppa, installera
Återställ (rr) Anger en resurs till ett fördefinierat tillstånd, till exempel ett tillstånd som anges av Checkpoint. Cmdleten startar Restore-Computer till exempel en systemåterställning på den lokala datorn. Reparera, returnera, ångra, åtgärda
Spara (sv) Bevarar data för att undvika förlust.
Synkronisering (sy) Garanterar att två eller flera resurser är i samma tillstånd. Replikera, coerce, matcha
Avpublicera (ub) Gör en resurs otillgänglig för andra. Det här verbet är kopplat till Publish. Avinstallera, Återställa, Dölj
Uppdatera (ud) Ger en resurs uppdaterad för att upprätthålla dess tillstånd, noggrannhet, överensstämmelse eller efterlevnad. Cmdleten uppdaterar Update-FormatData till exempel och lägger till formateringsfiler i den aktuella PowerShell-konsolen. Uppdatera, förnya, beräkna om, indexera om

Diagnostikverb

PowerShell använder klassen System.Management.Automation.VerbsDiagnostic för att definiera åtgärder som gäller för diagnostik. I följande tabell visas de flesta av de definierade verben.

Verb (alias) Åtgärd Synonymer att undvika
Felsöka (db) Undersöker en resurs för att diagnostisera driftproblem. Diagnostisera
Mått (ms) Identifierar resurser som används av en angiven åtgärd eller hämtar statistik om en resurs. Beräkna, fastställa, analysera
Ping (pi) Inaktuell – Använd verbet Test i stället.
Reparation (rp) Återställer en resurs till ett användbart villkor Åtgärda, återställa
Lösa (rv) Kartor en kort representation av en resurs till en mer fullständig representation. Expandera, fastställa
Test (t) Verifierar åtgärden eller konsekvensen för en resurs. Diagnostisera, analysera, bärga, verifiera
Trace (tr) Spårar aktiviteter för en resurs. Spåra, följa, inspektera, granska

Livscykelverb

PowerShell använder klassen System.Management.Automation.VerbsLifeCycle för att definiera åtgärder som gäller för en resurs livscykel. I följande tabell visas de flesta av de definierade verben.

Verb (alias) Åtgärd Synonymer att undvika
Godkänn (ap) Bekräftar eller godkänner status för en resurs eller process.
Assert (som) Bekräftar tillståndet för en resurs. Certify
Build (bd) Skapar en artefakt (vanligtvis en binär fil eller ett dokument) från en uppsättning indatafiler (vanligtvis källkod eller deklarativa dokument.) Det här verbet lades till i PowerShell 6.
Slutföra (cp) Avslutar en åtgärd.
Bekräfta (cn) Bekräftar, verifierar eller validerar tillståndet för en resurs eller process. Bekräfta, godkänn, certifiera, verifiera, verifiera
Neka (dn) Nekar, objekt, blockerar eller går emot tillståndet för en resurs eller process. Block, Object, Refuse, Reject
Distribuera (dp) Skickar ett program, en webbplats eller en lösning till ett fjärrmål på ett sådant sätt att en användare av lösningen kan komma åt den när distributionen är klar. Det här verbet lades till i PowerShell 6.
Inaktivera (d) Konfigurerar en resurs till ett otillgängligt eller inaktivt tillstånd. Till exempel gör Disable-PSBreakpoint cmdleten en brytpunkt inaktiv. Det här verbet är kopplat till Enable. Stoppa, dölj
Aktivera (e) Konfigurerar en resurs till ett tillgängligt eller aktivt tillstånd. Cmdleten gör Enable-PSBreakpoint till exempel en brytpunkt aktiv. Det här verbet är kopplat till Disable. Starta, börja
Installera (är) Placerar en resurs på en plats och initierar den om du vill. Det här verbet är kopplat till Uninstall. Installation
Anropa (i) Utför en åtgärd, till exempel att köra ett kommando eller en metod. Kör, Starta
Registrera (rg) Skapar en post för en resurs i en lagringsplats, till exempel en databas. Det här verbet är kopplat till Unregister.
Begäran (rq) Frågar efter en resurs eller ber om behörigheter.
Starta om (rt) Stoppar en åtgärd och startar den sedan igen. Cmdleten stoppar Restart-Service till exempel och startar sedan en tjänst. Återvinna
Återuppta (ru) Startar en åtgärd som har pausats. Cmdleten startar Resume-Service till exempel en tjänst som har inaktiverats. Det här verbet är kopplat till Suspend.
Start (sa) Initierar en åtgärd. Cmdleten Start-Service startar till exempel en tjänst. Det här verbet är kopplat till Stop. Starta, starta, starta
Stoppa (sp) Avbryter en aktivitet. Det här verbet är kopplat till Start. End, Kill, Terminate, Cancel
Skicka (sb) Presenterar en resurs för godkännande. Skicka
Pausa (ss) Pausar en aktivitet. Cmdleten Suspend-Service pausar till exempel en tjänst. Det här verbet är kopplat till Resume. Pausa
Avinstallera (oss) Tar bort en resurs från en angiven plats. Det här verbet är kopplat till Install.
Avregistrera (din) Tar bort posten för en resurs från en lagringsplats. Det här verbet är kopplat till Register. Ta bort
Vänta (w) Pausar en åtgärd tills en angiven händelse inträffar. Cmdleten pausar Wait-Job till exempel åtgärder tills ett eller flera av bakgrundsjobben har slutförts. Strömsparläge, pausa

Säkerhetsverb

PowerShell använder klassen System.Management.Automation.VerbsSecurity för att definiera säkerhetsåtgärder. I följande tabell visas de flesta av de definierade verben.

Verb (alias) Åtgärd Synonymer att undvika
Blockera (bl) Begränsar åtkomsten till en resurs. Det här verbet är kopplat till Unblock. Förhindra, begränsa, neka
Bevilja (gr) Ger åtkomst till en resurs. Det här verbet är kopplat till Revoke. Tillåt, Aktivera
Skydda (pt) Skyddar en resurs mot angrepp eller förlust. Det här verbet är kopplat till Unprotect. Kryptera, skydda, försegla
Återkalla (rk) Anger en åtgärd som inte tillåter åtkomst till en resurs. Det här verbet är kopplat till Grant. Ta bort, inaktivera
Avblockera (ul) Tar bort begränsningar för en resurs. Det här verbet är kopplat till Block. Clear, Allow
Ta bort skydd (upp) Tar bort skydd från en resurs som har lagts till för att förhindra angrepp eller förlust. Det här verbet är kopplat till Protect. Dekryptera, unseal

Andra verb

PowerShell använder klassen System.Management.Automation.VerbsOther för att definiera kanoniska verbnamn som inte passar in i en specifik kategori för verbnamn, till exempel vanliga verbnamn, kommunikation, data, livscykel eller namn på säkerhetsverb.

Verb (alias) Åtgärd Synonymer att undvika
Använd (u) Använder eller innehåller en resurs för att göra något.

Se även