about_Function_Provider

  • Artikel
  • 5 minuten om te lezen

Providernaam

Functie

Aandrijfeenheden

Function:

Functies

ShouldProcess

Korte beschrijving

Biedt toegang tot de functies die zijn gedefinieerd in PowerShell.

Gedetailleerde beschrijving

Met de PowerShell-functieprovider kunt u de functies en filters in PowerShell ophalen, toevoegen, wijzigen, wissen en verwijderen.

Een functie is een benoemd codeblok waarmee een actie wordt uitgevoerd. Wanneer u de functienaam typt, wordt de code in de functie uitgevoerd. Een filter is een benoemd codeblok waarmee voorwaarden voor een actie worden vastgesteld. U kunt de naam van het filter typen in plaats van de voorwaarde, zoals in een Where-Object opdracht.

Het functiestation is een platte naamruimte die alleen de functie- en filterobjecten bevat. Functies en filters hebben geen onderliggende items.

De functieprovider ondersteunt de volgende cmdlets, die in dit artikel worden behandeld.

Typen die door deze provider worden weergegeven

Elke functie is een exemplaar van de klasse System.Management.Automation.FunctionInfo . Elk filter is een exemplaar van de klasse System.Management.Automation.FilterInfo .

De functieprovider toont het gegevensarchief in het Function: station. Als u met functies wilt werken, kunt u uw locatie wijzigen in het Function: station (Set-Location Function:). U kunt ook vanaf een ander PowerShell-station werken. Als u wilt verwijzen naar een functie vanaf een andere locatie, gebruikt u de stationsnaam (Function:) in het pad.

Set-Location Function:

Als u wilt terugkeren naar een bestandssysteemstation, typt u de naam van het station. Typ bijvoorbeeld:

Set-Location C:

U kunt ook met de functieprovider werken vanaf een ander PowerShell-station. Als u wilt verwijzen naar een functie vanaf een andere locatie, gebruikt u de stationsnaam Function: in het pad.

Notitie

PowerShell maakt gebruik van aliassen om u vertrouwd te laten werken met providerpaden. Opdrachten zoals dir en ls zijn nu aliassen voor Get-ChildItem, cd is een alias voor Set-Location. en pwd is een alias voor Get-Location.

Functies verkrijgen

Met deze opdracht wordt de lijst met alle functies in de huidige sessie opgeslagen. U kunt deze opdracht gebruiken vanaf elk PowerShell-station.

Get-ChildItem -Path Function:

De functieprovider heeft geen containers, dus de bovenstaande opdracht heeft hetzelfde effect wanneer deze wordt gebruikt met Get-ChildItem.

Get-ChildItem -Path Function:

U kunt de definitie van een functie ophalen door toegang te krijgen tot de eigenschap Definitie , zoals hieronder wordt weergegeven.

(Get-Item -Path function:more).Definition

U kunt ook de definitie van een functie ophalen met behulp van het providerpad dat is voorafgegaan door het dollarteken ($).

$function:more

Geselecteerde functies verkrijgen

Met deze opdracht wordt de man functie opgehaald van het Function: station. De cmdlet wordt gebruikt Get-Item om de functie op te halen. De pijplijnoperator (|) verzendt het resultaat naar Format-Table. De -Wrap parameter stuurt tekst die niet op de regel past op de volgende regel. De -Autosize parameter wijzigt het formaat van de tabelkolommen zodat deze geschikt zijn voor de tekst.

Get-Item -Path man | Format-Table -Wrap -Autosize

Werken met functieproviderpaden

Met deze opdrachten krijgt u beide de functie met de naam c:. De eerste opdracht kan worden gebruikt in elk station. De tweede opdracht wordt gebruikt in het Function: station. Omdat de naam eindigt op een dubbele punt, de syntaxis voor een station, moet u het pad kwalificeren met de stationsnaam. Binnen het Function: station kunt u beide indelingen gebruiken. In de tweede opdracht vertegenwoordigt de punt (.) de huidige locatie.

PS C:\> Get-Item -Path Function:c:
PS Function:\> Get-Item -Path .\c:

Een functie maken

Met deze opdracht wordt de cmdlet gebruikt om een functie met de New-Item naam Win32:te maken. De expressie in accolades is het scriptblok dat wordt vertegenwoordigd door de functienaam.

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

U kunt ook een functie maken door deze te typen op de PowerShell-opdrachtregel. Bijvoorbeeld tpe Function:Win32: {Set-Location C:\Windows\System32}. Als u zich in het station bevindt, kunt u de naam van het Function: station weglaten.

Een functie verwijderen

Met deze opdracht verwijdert u de more: functie uit de huidige sessie.

Remove-Item Function:more:

Een functie wijzigen

Met deze opdracht wordt de Set-Item cmdlet gebruikt om de prompt functie te wijzigen, zodat deze de tijd vóór het pad weergeeft.

Set-Item -Path Function:prompt -Value {
  'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '
  }

De naam van een functie wijzigen

Met deze opdracht wordt de Rename-Item cmdlet gebruikt om de naam van de help functie te wijzigen in gh.

Rename-Item -Path Function:help -NewName gh

Een functie kopiëren

Met deze opdracht wordt de prompt functie gekopieerd naar oldPrompteen nieuwe naam voor het scriptblok dat is gekoppeld aan de promptfunctie. U kunt deze functie gebruiken om de oorspronkelijke promptfunctie op te slaan als u deze wilt wijzigen. De eigenschap Opties van de nieuwe functie heeft een waarde van None. Als u de waarde van de eigenschap Opties wilt wijzigen, gebruikt u Set-Item.

Copy-Item -Path Function:prompt -Destination Function:oldPrompt

Dynamische parameters

Dynamische parameters zijn cmdlet-parameters die worden toegevoegd door een PowerShell-provider en zijn alleen beschikbaar wanneer de cmdlet wordt gebruikt in het station met provider.

Opties <[System.Management.Automation.ScopedItemOptions]>

Bepaalt de waarde van de eigenschap Opties van een functie.

  • None: Geen opties. None is de standaardwaarde.
  • Constant: De functie kan niet worden verwijderd en de eigenschappen ervan kunnen niet worden gewijzigd. Constant is alleen beschikbaar wanneer u een functie maakt. U kunt de optie van een bestaande functie niet wijzigen in Constant.
  • Private: De functie is alleen zichtbaar in het huidige bereik
  • (niet in onderliggende bereiken).
  • ReadOnly: De eigenschappen van de functie kunnen niet worden gewijzigd, behalve met behulp van de -Force parameter. U kunt Remove-Item de functie verwijderen.
  • AllScope: De functie wordt gekopieerd naar nieuwe bereiken die worden gemaakt.

Ondersteunde cmdlets

De pijplijn gebruiken

Provider-cmdlets accepteren pijplijninvoer. U kunt de pijplijn gebruiken om de taak te vereenvoudigen door providergegevens van de ene cmdlet naar een andere provider-cmdlet te verzenden. Zie de cmdlet-verwijzingen in dit artikel voor meer informatie over het gebruik van de pijplijn met provider-cmdlets.

Ondersteuning vragen

Vanaf Windows PowerShell 3.0 kunt u aangepaste Help-onderwerpen krijgen voor provider-cmdlets die uitleggen hoe deze cmdlets zich gedragen op een bestandssysteemstation.

Als u de Help-onderwerpen wilt ophalen die zijn aangepast voor het bestandssysteemstation, voert u een Get-Help-opdracht uit in een bestandssysteemstation of gebruikt u de -Path parameter Get-Help om een bestandssysteemstation op te geven.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path function:

Zie ook