about_Function_Provider

Szolgáltató neve

Függvény

Drives

Function:

Capabilities

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. A dir és ls parancsok mostantól Get-ChildItemaliasai, cd a helymeghatározó aliasa, pwd pedig a Get-Locationaliasa.

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énynév által képviselt szkriptblokk.

New-Item -Path Function:Win32: -Value {Set-Location C:\Windows\System32}

Hatókörök

A változókhoz hasonlóan a függvények is egy adott hatókörhöz tartoznak. Amikor létrehoz egy függvényt, az csak abban a hatókörben érhető el, amelyben a függvényt létrehozták. Ha elérhetővé szeretne tenni egy függvényt, használjon hatókör-módosítót a függvény létrehozásakor. További információ található a about_Scopesrészben.

Az alábbi példa a Global: hatókör-módosító használatával hoz létre egy függvényt a globális hatókörben.

function New-Function {
    param(
        [string] $Name,
        [scriptblock] $Script
    )

    $lp = "Function:\Global:$($Name)"
    Set-Item -LiteralPath $lp -Value $Script -PassThru -Force
}

New-Function -Name 'Win32:' -Script { Set-Location C:\Windows\System32 }

A Global: hatókör-módosító nélkül a függvény a helyi hatókörben jönne létre. Ha New-Function kilép, az újonnan létrehozott függvény már nem létezik.

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 a függvényt oldPrompta prompt parancssori függvényhez társított szkriptblokk új nevének létrehozásával másolja át. 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

  • Utolsó frissítés időpontja: