about_Function_Provider

  • Cikk

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é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 dirls 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 oldPrompta 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. A None 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ények Constantbeá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