Godkända verb för PowerShell-kommandon

PowerShell använder ett verb-Substantiv-par för namn på cmdlets och för deras härledda .NET-klasser. Verbets del av namnet identifierar den åtgärd som cmdleten utför. Substantiv delen av namnet identifierar den entitet som åtgärden utförs på. Till exempel Get-Command hämtar cmdleten alla kommandon som är registrerade i PowerShell.

Anteckning

PowerShell använder termen verb för att beskriva ett ord som förutsätter en åtgärd även om ordet inte är ett standard-verb på det engelska språket. Termen nytt är till exempel ett giltigt PowerShell-verb eftersom det innebär en åtgärd trots att det inte är ett verb på det engelska språket.

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

Rekommendationer för namngivning av verb

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 cmdletar som du skapar, de cmdletar som tillhandahålls av PowerShell och de cmdletar som har utformats av andra.

  • Använd ett av de fördefinierade verben som tillhandahålls av PowerShell
  • Använd verbet för att beskriva det allmänna omfånget för åtgärden och Använd parametrar för att ytterligare förfina cmdletens åtgärd.
  • Använd inte en synonym till ett godkänt verb. Till exempel Använd alltid Remove , aldrig användning Delete eller Eliminate .
  • Använd endast formuläret för varje verb som anges 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 eller en sällsynt del av dess cmdlet använder dessa verb under exceptionella omständigheter.
    • ()
    • Format (f): ordna objekt i ett angivet formulär eller en viss layout
    • Grupp (GP): ordnar eller kopplar samman en eller flera resurser
    • Ping (PI)
    • Sortera (SR)
    • Tee (te)
    • Var (vad än är)

Du kan få en fullständig lista över verb som använder Get-Verb cmdleten.

Liknande verb för olika åtgärder

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

Ny vs. Set

Använd New verbet för att skapa en ny resurs. Använd Set verbet för att ändra en befintlig resurs, om den inte redan finns, t Set-Variable . ex. cmdleten.

Använd Find verbet för att söka efter ett objekt. Använd Search verbet för att skapa en referens till en resurs i en behållare.

Hämta kontra läsa

Använd Get 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 använda för att få åtkomst till resursen i framtiden. Använd Read verbet för att öppna en resurs och antingen extrahera information som finns i.

Invoke vs. start

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

Ping mot test

Använd Test verbet.

Vanliga verb

PowerShell använder uppräknings klassen system. Management. Automation. VerbsCommon 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) Action Synonymer för att undvika
Lägg till (a) Lägger till en resurs i en behållare eller bifogar ett objekt till ett annat objekt. Till exempel Add-Content lägger cmdleten till innehåll till en fil. Verbet är länkat till Remove . Lägg till, bifoga, sammanfoga, infoga
Rensa (cl) Tar bort alla resurser från en behållare men tar inte bort behållaren. Till exempel Clear-Content tar cmdleten bort innehållet i en fil men tar inte bort filen. Rensa, radera, släppa, avmarkera, unset, upphäver
Stäng (CS) Ändrar status för en resurs så att den blir otillgänglig, otillgänglig eller oanvändbar. Verbet är länkat till Open.
Kopiera (CP) Kopierar en resurs till ett annat namn eller till en annan behållare. Till exempel Copy-Item kopierar cmdleten ett objekt (till exempel en fil) från en plats i data lagret till en annan plats. Duplicera, klona, replikera, synkronisera
RETUR (et) Anger en åtgärd som gör det möjligt för användaren att flytta till en resurs. Till exempel Enter-PSSession placerar cmdleten användaren i en interaktiv session. Verbet är länkat till Exit . Push-överför till
Avsluta (t ex) Anger den aktuella miljön eller kontexten till den senast använda kontexten. Till exempel Exit-PSSession placerar cmdleten användaren i sessionen som användes för att starta den interaktiva sessionen. Verbet är länkat till Enter . Pop, ut
Sök (fd) Söker efter ett objekt i en behållare som är okänt, underförstådd, valfri eller angiven. Sök
Hämta (g) Anger en åtgärd som hämtar en resurs. Verbet är länkat till Set . Läsa, öppna, katta, skriva, dir, Hämta, dumpa, Hämta, undersöka, söka efter
Dölj (h) Gör en resurs okänd. Till exempel kan en-cmdlet som innehåller namnet Dölj verb dölja en tjänst från en användare. Verbet är länkat till Show . Blockera
Anslut (j) Kombinerar resurser till en resurs. Till exempel Join-Path kombinerar cmdleten en sökväg med en av dess underordnade sökvägar för att skapa en enskild sökväg. Verbet är länkat till Split . Kombinera, Unita, Anslut, koppla
Lås (LK) Skyddar en resurs. Verbet är länkat till Unlock . Begränsa, säkra
Flytta (m) Flyttar en resurs från en plats till en annan. Till exempel Move-Item flyttar cmdleten ett objekt från en plats i data lagret till en annan plats. Överföring, namn, migrera
Ny (n) Skapar en resurs. ( Set Verbet kan också användas när du skapar en resurs som innehåller data, t. ex Set-Variable . cmdleten.) Skapa, generera, skapa, skapa, allokera
Öppna (OP) Ändrar status för en resurs för att göra den tillgänglig, tillgänglig eller användbar. Verbet är länkat till Close .
Optimera (om) Ökar effektiviteten för en resurs.
Pop (pop) Tar bort ett objekt från toppen av en stack. Till exempel Pop-Location ändrar cmdleten den aktuella platsen till den plats som senast skickades till stacken.
Push (PU) Lägger till ett objekt överst i en stack. Till exempel push- Push-Location cmdleten den aktuella platsen till stacken.
Gör om (re) Återställer en resurs till det tillstånd som har gjorts om.
Ta bort (r) Tar bort en resurs från en behållare. Till exempel Remove-Variable tar cmdleten bort en variabel och dess värde. Verbet är länkat till Add . Rensa, klippa ut, ta bort, ta bort, radera
Byt namn (RN) Ändrar namnet på en resurs. Till exempel,- Rename-Item cmdleten, som används för att komma åt lagrade data, ändrar namnet på ett objekt i data lagret. Ändra
Återställ (RS) Återställer en resurs tillbaka till ursprungligt tillstånd.
Ändra storlek(RZ) Ändrar storleken på en resurs.
Sök (SR) Skapar en referens till en resurs i en behållare. Hitta, leta upp
Välj (SC) Söker efter en resurs i en behållare. Till exempel Select-String söker cmdleten efter text i strängar och filer. Hitta, leta upp
Set (s) Ersätter data på en befintlig resurs eller skapar en resurs som innehåller vissa data. Till exempel Set-Date ändrar cmdleten system tiden på den lokala datorn. ( New Verbet kan också användas för att skapa en resurs.) Verbet är länkat till Get . Skriva, återställa, tilldela, konfigurera
Visa (SH) Gör en resurs synlig för användaren. Verbet är länkat till Hide . Visa, producera
Hoppa över (SK) Hoppar över en eller flera resurser eller punkter i en sekvens. Kringgå, hoppa
Dela (SL) Separerar delar av en resurs. Till exempel Split-Path returnerar cmdleten olika delar av en sökväg. Verbet är länkat till Join . Särskilt
Steg (st) Flyttar till nästa punkt eller resurs i en sekvens.
Växel (SW) Anger en åtgärd som växlar mellan två resurser, t. ex. för att ändra mellan två platser, ansvars områden eller tillstånd.
Ångra (UN) Anger en resurs till sitt tidigare tillstånd.
Lås upp (Storbritannien) Frigör en resurs som är låst. Verbet är länkat till Lock . Frigör, begränsa och ta bort skydd
Titta (WC) Kontrollerar eller övervakar kontinuerligt en resurs efter ändringar.

Kommunikations verb

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) Action Synonymer för att undvika
Anslut (CC) Skapar en länk mellan en källa och ett mål. Verbet är länkat till Disconnect . Anslut till, Telnet
Koppla från (DC) Bryter länken mellan en källa och ett mål. Verbet är länkat till Connect . Bryt, logga ut
Läs (RD) Hämtar information från en källa. Verbet är länkat till Write . Hämta, prompt, Hämta
Ta emot (RC) Accepterar information som skickas från en källa. Verbet är länkat till Send . Läs, Godkänn, granska
Skicka (SD) Levererar information till ett mål. Verbet är länkat till Receive . Skicka, Sänd, e-post, Fax
Skriva (WR) Lägger till information till ett mål. Verbet är länkat till Read . Lägg till, Skriv ut

Dataverb

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

Verb (alias) Action Synonymer för att undvika
Säkerhets kopiering (ba) Lagrar data genom att replikeras. Spara, Bränn, replikera, synkronisera
Kontroll punkt (CH) Skapar en ögonblicks bild av dataens aktuella tillstånd 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. Par med Expand . Oftast
Konvertera (ka) Ä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 data typer. Ändra, ändra storlek, sampla om
ConvertFrom (CF) Konverterar en primär typ av indata (cmdleten Substantiv visar indata) till en eller flera typer av utdata som stöds. Exportera, skriva ut, ut
ConvertTo (CT) Konverterar från en eller flera typer av indata till en primär Utdatatyp (cmdleten Substantiv visar utdatatypen). Importera, inmatat i
Demontera (DM) Kopplar från en namngiven entitet från en plats. Verbet är länkat 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 ursprungs läget. Verbet är länkat till Compress . Expandera, expandera
Exportera (EP) Kapslar in primär indata i ett beständigt data lager, till exempel en fil eller till ett Interchange Format. Verbet är länkat till Import . Extrahera, säkerhetskopiera
Importera (IP) Skapar en resurs från data som lagras i ett beständigt data lager (till exempel en fil) eller i ett Interchange Format. Till exempel Import-CSV importerar cmdleten data från en fil med kommaavgränsade värden (CSV) till objekt som kan användas av andra cmdletar. Verbet är länkat till Export . BulkLoad, Läs in
Initiera (in) Förbereder en resurs för användning och ställer in den till ett standard tillstånd. Radera, init, förnya, återskapa, initiera om, konfigurera
Gräns (l) Tillämpar begränsningar för en resurs. Kvot
Sammanslagning (mg) Skapar en enskild resurs från flera resurser. Kombinera, förena
Montera (MT) Bifogar en namngiven entitet till en plats. Verbet är länkat till Dismount . Ansluta
Ut (o) Skickar data från miljön. Till exempel Out-Printer skickar cmdleten data till en skrivare.
Publicera (PB) Gör en resurs tillgänglig för andra. Verbet är länkat till Unpublish . Distribuera, släpp, installera
Återställ (RR) Anger en resurs till ett fördefinierat tillstånd, till exempel ett tillstånd som anges av Checkpoint . Till exempel Restore-Computer startar cmdleten en system återställning på den lokala datorn. Reparera, återställa, ångra, åtgärda
Spara (sv) Bevarar data för att undvika förlust.
Synkronisera (sy) Säkerställer att två eller flera resurser är i samma tillstånd. Replikera, tvinga, matcha
Avpublicera (UB) Gör en resurs otillgänglig för andra. Verbet är länkat till Publish . Avinstallera, återgå, Dölj
Uppdatera (UD) Ger en resurs uppdaterad för att bevara dess tillstånd, riktighet, överensstämmelse eller efterlevnad. Till exempel Update-FormatData uppdaterar cmdleten och lägger till filer i den aktuella PowerShell-konsolen. Uppdatera, förnya, omberäkna och indexera igen

Diagnostiska verb

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

Verb (alias) Action Synonymer för att undvika
Felsöka (dB) Undersöker en resurs för att diagnosticera drifts problem. Diagnostisera
Mått (MS) Identifierar resurser som används av en angiven åtgärd eller hämtar statistik om en resurs. Beräkna, bestämma, analysera
Reparera (RP) Återställer en resurs till ett användbart villkor Korrigera, återställa
Lösning (RV) Mappar en kort representation av en resurs till en mer fullständig representation. Expandera, bestäm
Testa (t) Verifierar åtgärden eller konsekvensen för en resurs. Diagnostisera, analysera, rädda, verifiera
Trace (TR) Spårar aktiviteter för en resurs. Spåra, följa, inspektera och gräva

Livscykler-verb

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

Verb (alias) Action Synonymer för att undvika
Godkänn (AP) Bekräftar eller accepterar status för en resurs eller process.
Assert (as) Bekräftar statusen för en resurs. Certify
Bygge (BD) Skapar en artefakt (vanligt vis ett binärt eller dokument) av en uppsättning indatafiler (vanligt vis käll kod eller deklarativ dokument). Det här verbet lades till i PowerShell 6.
Slutför (CP) Avslutar en åtgärd.
Bekräfta (CN) Bekräftar, verifierar eller verifierar status för en resurs eller process. Bekräfta, Godkänn, certifiera, verifiera, verifiera
Neka (DN) Nekar, objekt, blockerar eller motsätter sig statusen för en resurs eller process. Blockera, objekt, neka, avvisa
Distribuera (DP) Skickar ett program, en webbplats eller en lösning till ett fjärrmål [s] på ett sådant sätt att en konsument av lösningen kan komma åt den när distributionen har slutförts. Det här verbet lades till i PowerShell 6.
Inaktivera (d) Konfigurerar en resurs till ett otillgängligt eller inaktivt tillstånd. Till exempel Disable-PSBreakpoint gör cmdleten en inaktiv Bryt punkt. Verbet är länkat till Enable . Stoppa, Dölj
Aktivera (e) Konfigurerar en resurs till ett tillgängligt eller aktivt tillstånd. Till exempel Enable-PSBreakpoint gör cmdleten en aktiv Bryt punkt. Verbet är länkat till Disable . Starta, börja
Installera (är) Placerar en resurs på en plats och eventuellt initierar den. Verbet är länkat till Uninstall . Installation
Anropa (i) Utför en åtgärd, till exempel köra ett kommando eller en metod. Kör, starta
Registrera (RG) Skapar en post för en resurs i en lagrings plats, till exempel en databas. Verbet är länkat till Unregister .
Begäran (RQ) Frågar efter en resurs eller ber om behörighet.
Starta om (RT) Stoppar en åtgärd och startar sedan den igen. Till exempel Restart-Service stoppas cmdleten och startar sedan en tjänst. Pappers
Fortsätt (ru) Startar en åtgärd som har pausats. Till exempel Resume-Service startar cmdleten en tjänst som har pausats. Verbet är länkat till Suspend .
Starta (sa) Initierar en åtgärd. Till exempel Start-Service startar cmdleten en tjänst. Verbet är länkat till Stop . Starta, initiera, starta
Stoppa (SP) Avvecklar en aktivitet. Verbet är länkat till Start . Avsluta, avsluta, Avbryt
Skicka (SB) Visar en resurs för godkännande. Skicka
Pausa (SS) Pausar en aktivitet. Till exempel Suspend-Service pausar cmdleten en tjänst. Verbet är länkat till Resume . Pausa
Avinstallera (US) Tar bort en resurs från en angiven plats. Verbet är länkat till Install .
Avregistrera (din) Tar bort posten för en resurs från en lagrings plats. Verbet är länkat till Register . Ta bort
Vänta (w) Pausar en åtgärd tills en angiven händelse inträffar. Cmdleten kan till exempel Wait-Job pausa åtgärder tills ett eller flera bakgrunds jobb är slutförda. Vilo läge, pausa

Säkerhetsverb

PowerShell använder klassen system. Management. Automation. VerbsSecurity för att definiera åtgärder som ska vidtas för säkerhet. I följande tabell visas de flesta av de definierade verben.

Verb (alias) Action Synonymer för att undvika
Blockera (bl) Begränsar åtkomsten till en resurs. Verbet är länkat till Unblock . Förhindra, begränsa, neka
Bevilja (gr) Tillåter åtkomst till en resurs. Verbet är länkat till Revoke . Tillåt, aktivera
Skydda (PT) Skyddar en resurs från angrepp eller förlust. Verbet är länkat till Unprotect . Kryptera, skydda, försegla
Återkalla (lib) Anger en åtgärd som inte tillåter åtkomst till en resurs. Verbet är länkat till Grant . Ta bort, inaktivera
Avblockera (UL) Tar bort begränsningar för en resurs. Verbet är länkat till Block . Rensa, Tillåt
Ta bort skydd (upp) Tar bort skydd från en resurs som har lagts till för att förhindra angrepp eller förlust. Verbet är länkat till Protect . Dekryptera, avförslut

Andra verb

PowerShell använder klassen system. Management. Automation. VerbsOther för att definiera kanoniska verb som inte passar in i en viss kategori för verb, till exempel verben common, Communications, data, Lifecycle eller Security verb.

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

Se även