about_Function_Provider
Szolgáltató neve
Függvény
Meghajtók
Function:
Képességek
ShouldProcess
Rövid leírás
Hozzáférést biztosít a PowerShellben definiált függvényekhez.
Részletes leírás
A PowerShell-függvényszolgáltató lehetővé teszi a Függvények és szűrők lekérését, hozzáadását, módosítását, törlését és törlését a PowerShellben.
A függvény egy elnevezett kódblokk, amely végrehajt egy műveletet. Amikor beírja a függvény nevét, a függvényben lévő kód fut. A szűrő egy elnevezett kódblokk, amely feltételeket határoz meg egy művelethez. A szűrő nevét beírhatja a feltétel helyett, például egy Where-Object
parancsba.
A függvénymeghajtó egy egyszerű névtér, amely csak a függvényt és a szűrőobjektumokat tartalmazza. Sem a függvények, sem a szűrők nem rendelkeznek gyermekelemekkel.
A függvényszolgáltató az alábbi parancsmagokat támogatja, amelyekről ebben a cikkben szó van.
A szolgáltató által közzétett típusok
Minden függvény a System.Management.Automation.FunctionInfo osztály egy példánya. Minden szűrő a System.Management.Automation.FilterInfo osztály egy példánya.
A függvénymeghajtó navigálása
A függvényszolgáltató elérhetővé teszi az adattárát a Function:
meghajtón. A függvények használatához módosíthatja a helyét a Function:
meghajtóra (Set-Location Function:
). Másik PowerShell-meghajtóról is dolgozhat. Ha másik helyről szeretne függvényre hivatkozni, használja az elérési út meghajtónevét (Function:
).
Set-Location Function:
Fájlrendszer-meghajtóra való visszatéréshez írja be a meghajtó nevét. Írja be például a következőt:
Set-Location C:
A függvényszolgáltatóval bármely más PowerShell-meghajtóról is dolgozhat. Ha másik helyről szeretne függvényre hivatkozni, használja a meghajtó nevét Function:
az elérési úton.
Feljegyzés
A PowerShell aliasokkal teszi lehetővé a szolgáltatói útvonalakkal való munkavégzést. Az olyan parancsok, mint például dir
ls
a Get-ChildItem aliasai, cd
a Set-Location aliasai. és pwd
a Get-Location aliasa.
Függvények lekérése
Ez a parancs lekéri az aktuális munkamenet összes függvényének listáját. Ezt a parancsot bármely PowerShell-meghajtóról használhatja.
Get-ChildItem -Path Function:
A függvényszolgáltató nem rendelkezik tárolókkal, így a fenti parancsnak ugyanaz a hatása, amikor a függvényt használja Get-ChildItem
.
Get-ChildItem -Path Function:
A függvény definícióját a Definíció tulajdonság elérésével lehet lekérni, ahogy az alább látható.
(Get-Item -Path function:more).Definition
A függvény definícióját is lekérheti a dollárjel ($
) előtaggal előtaggal rendelkező szolgáltatói elérési út használatával.
$function:more
Ha egy kötőjelet (-
) tartalmazó függvény definícióját szeretné lekérni, csomagolja be az értéket a dollárjel kapcsos zárójelekbe való beolvasása után.
${function:Clear-Host}
Kijelölt függvények lekérése
Ez a parancs lekéri a függvényt man
a Function:
meghajtóról. A függvény lekéréséhez a Get-Item
parancsmagot használja. A folyamatüzemeltető (|
) elküldi az eredményt a következőnek Format-Table
: . A -Wrap
paraméter a soron nem szereplő szöveget a következő sorra irányítja. A -Autosize
paraméter átméretezi a táblázat oszlopait, hogy elférjenek a szövegben.
Get-Item -Path man | Format-Table -Wrap -Autosize
A függvényszolgáltató elérési útjainak használata
Ezek a parancsok a függvényt is lekérik c:
. Az első parancs bármely meghajtón használható. A meghajtón a második parancsot használja a Function:
rendszer. Mivel a név kettősponttal végződik, amely egy meghajtó szintaxisa, az elérési utat a meghajtó nevével kell minősíteni. A meghajtón Function:
belül bármelyik formátumot használhatja. A második parancsban a pont (.
) az aktuális helyet jelöli.
PS C:\> Get-Item -Path Function:c:
PS Function:\> Get-Item -Path .\c:
Függvény létrehozása
Ez a parancs a New-Item
parancsmaggal hoz létre egy úgynevezett Win32:
függvényt.
A kapcsos zárójelek kifejezése a függvény neve által képviselt szkriptblokk.
New-Item -Path Function:Win32: -Value {Set-Location C:\Windows\System32}
A függvényt úgy is létrehozhatja, hogy beírja a PowerShell parancssorba. Például: tpe Function:Win32: {Set-Location C:\Windows\System32}
. Ha a Function:
meghajtón van, kihagyhatja a meghajtó nevét.
Függvény törlése
Ez a parancs törli a függvényt more:
az aktuális munkamenetből.
Remove-Item Function:more:
Függvény módosítása
Ez a parancs a Set-Item
parancsmaggal módosítja a prompt
függvényt, hogy megjelenjen az elérési út előtti idő.
Set-Item -Path Function:prompt -Value {
'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '
}
Függvény átnevezése
Ez a parancs a parancsmagot használja a Rename-Item
függvény nevének help
módosításához gh
.
Rename-Item -Path Function:help -NewName gh
Függvény másolása
Ez a parancs átmásolja a prompt
függvényt oldPrompt
a parancssori függvényhez társított szkriptblokk új nevének létrehozásával.
Ezzel mentheti az eredeti parancssori függvényt, ha módosítani szeretné.
Az új függvény Beállítások tulajdonsága a következő értékkel rendelkezik None
: . A Beállítások tulajdonság értékének módosításához használja a következőtSet-Item
: .
Copy-Item -Path Function:prompt -Destination Function:oldPrompt
Dinamikus paraméterek
A dinamikus paraméterek olyan parancsmagparaméterek, amelyeket egy PowerShell-szolgáltató ad hozzá, és csak akkor érhetők el, ha a parancsmagot a szolgáltató által engedélyezett meghajtón használják.
Beállítások <[System.Management.Automation.ScopedItemOptions]>
Egy függvény Beállítások tulajdonságának értékét határozza meg.
None
: Nincs lehetőség. ANone
az alapértelmezett formátum.Constant
: A függvény nem törölhető, és tulajdonságai nem módosíthatók.Constant
csak függvény létrehozásakor érhető el. A meglévő függvényekConstant
beállítását nem módosíthatja .Private
: A függvény csak az aktuális hatókörben látható- (nem gyermekhatókörben).
ReadOnly
: A függvény tulajdonságai csak a-Force
paraméter használatával módosíthatók.Remove-Item
A függvényt törölheti.AllScope
: A függvény a létrehozott új hatókörökbe lesz másolva.
Támogatott parancsmagok
A folyamat használata
A szolgáltatói parancsmagok elfogadják a folyamatbemenetet. A folyamat használatával egyszerűsítheti a feladatokat, ha szolgáltatói adatokat küld egy parancsmagból egy másik szolgáltatói parancsmagnak. A folyamat szolgáltatói parancsmagokkal való használatával kapcsolatos további információkért tekintse meg a cikkben található parancsmag-hivatkozásokat.
Segítség kérése
A Windows PowerShell 3.0-tól kezdve testre szabott súgótémaköröket kaphat a szolgáltatói parancsmagokhoz, amelyek ismertetik, hogyan viselkednek ezek a parancsmagok a fájlrendszer-meghajtókon.
A fájlrendszer-meghajtóra szabott súgótémakörök lekéréséhez futtasson egy Get-Help parancsot egy fájlrendszer-meghajtón, vagy a -Path
Get-Help paraméterrel adjon meg egy fájlrendszer-meghajtót.
Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path function:
Lásd még
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: