Delen via

Naslaginformatie over Azure Functions Core Tools

Dit artikel bevat referentiedocumentatie voor de Azure Functions Core Tools. Met deze lokale runtime en opdrachtregelprogramma's kunt u Azure Functions-projecten ontwikkelen, beheren en implementeren vanaf uw lokale computer. Zie Werken met Azure Functions Core Tools voor meer informatie over het gebruik van Core Tools.

Core Tools-opdrachten zijn ingedeeld in de volgende contexten, die elk een unieke set acties bieden.

Opdrachtcontext Beschrijving
func Opdrachten voor het maken en uitvoeren van functies op uw lokale computer.
func azure Opdrachten voor het werken met Azure-resources, waaronder publiceren.
func azurecontainerapps Een containerfunctie-app implementeren in Azure Container Apps.
func durable Opdrachten voor het werken met Durable Functions.
func extensions Opdrachten voor het installeren en beheren van extensies.
func kubernetes Opdrachten voor het werken met Kubernetes en Azure Functions.
func settings Opdrachten voor het beheren van omgevingsinstellingen voor de lokale Functions-host.
func templates Opdrachten voor het weergeven van beschikbare functiesjablonen.

Voordat u de opdrachten in dit artikel gebruikt, moet u de Core Tools installeren.

func init

Hiermee maakt u een nieuw Functions-project in een specifieke taal.

func init <PROJECT_FOLDER>

Wanneer u het project opgeeft <PROJECT_FOLDER>, wordt het gemaakt in een nieuwe map met deze naam. Anders wordt de huidige map gebruikt.

func init ondersteunt de volgende opties, die geen ondersteuning bieden voor versie 1.x, tenzij anders vermeld:

Optie Beschrijving
--csx Hiermee maakt u .NET-functies als C#-script. Dit is het gedrag van versie 1.x. Alleen geldig met --worker-runtime dotnet.
--docker Hiermee maakt u een Dockerfile voor een container met behulp van een basisinstallatiekopieën die is gebaseerd op de gekozen --worker-runtime. Gebruik deze optie wanneer u van plan bent om een containerfunctie-app te implementeren.
--docker-only Hiermee voegt u een Dockerfile toe aan een bestaand project. Vraagt om de worker-runtime als deze niet is opgegeven of ingesteld in local.settings.json. Gebruik deze optie wanneer u van plan bent een containerfunctie-app te implementeren en het project al bestaat.
--force Initialiseer het project zelfs wanneer er bestaande bestanden in het project zijn. Met deze instelling worden bestaande bestanden met dezelfde naam overschreven. Andere bestanden in de projectmap worden niet beïnvloed.
--language Initialiseert een taalspecifiek project. Momenteel ondersteund wanneer --worker-runtime deze is ingesteld op node. Opties zijn typescript en javascript. U kunt ook --worker-runtime javascript gebruiken of --worker-runtime typescript.
--managed-dependencies Hiermee worden beheerde afhankelijkheden geïnstalleerd. Momenteel ondersteunt alleen de PowerShell-werkruntime deze functionaliteit.
--model Hiermee stelt u het gewenste programmeermodel in voor een doeltaal wanneer er meer dan één model beschikbaar is. Ondersteunde opties zijn V1 en V2 voor Python en V3V4 voor Node.js. Zie de ontwikkelaarshandleiding voor Python en de Node.js ontwikkelaarshandleiding voor meer informatie.
--source-control Hiermee bepaalt u of er een Git-opslagplaats wordt gemaakt. Standaard wordt er geen opslagplaats gemaakt. Wanneer true, wordt er een opslagplaats gemaakt.
--worker-runtime Hiermee stelt u de taalruntime voor het project in. Ondersteunde waarden zijn: csharp, dotnet, dotnet-isolated, , javascript,node (standaard ingesteld op JavaScript), powershell, en typescriptpython. Gebruik Maven voor Java. Als u een taalneutraal project wilt genereren met alleen de projectbestanden, gebruikt u custom. Wanneer deze niet is ingesteld, wordt u gevraagd om uw runtime te kiezen tijdens de initialisatie.
--target-framework Hiermee stelt u het doelframework voor het functie-app-project in. Alleen geldig met --worker-runtime dotnet-isolated. Ondersteunde waarden zijn: net10.0 (preview), net9.0( net8.0 standaard) net6.0en net48 (.NET Framework 4.8).

Notitie

Wanneer u een --docker van beide of --docker-only opties gebruikt, maakt Core Tools automatisch de Dockerfile voor C#-, JavaScript-, Python- en PowerShell-functies. Voor Java-functies moet u het Dockerfile handmatig maken. Zie Containerized Functie-apps maken voor meer informatie.

func logs

Hiermee haalt u logboeken op voor functies die worden uitgevoerd in een Kubernetes-cluster.

func logs --platform kubernetes --name <APP_NAME>

De func logs actie ondersteunt de volgende opties:

Optie Beschrijving
--platform Hostingplatform voor de functie-app. Ondersteunde opties: kubernetes.
--name Naam van functie-app in Azure.

Zie Azure Functions in Kubernetes met KEDA voor meer informatie.

func new

Hiermee maakt u een nieuwe functie in het huidige project op basis van een sjabloon.

func new

Wanneer u zonder de func new optie uitvoert--template, wordt u gevraagd een sjabloon te kiezen. In versie 1.x moet u de --language optie gebruiken om de taal in te stellen.

De func new actie ondersteunt de volgende opties:

Optie Beschrijving
--authlevel Stel het autorisatieniveau in voor een HTTP-trigger. Ondersteunde waarden zijn: function, anonymous, admin. Autorisatie wordt niet afgedwongen wanneer deze lokaal wordt uitgevoerd. Zie Autorisatieniveau voor meer informatie.
--csx Hiermee worden dezelfde C#-scriptsjablonen (.csx) gegenereerd die worden gebruikt door versie 1.x en in de portal-editor.
--language, -l Alleen in versie 1.x opnieuwguired. In alle andere versies wordt de taal gedefinieerd door de --worker-runtime waarde die wordt doorgegeven aan func init.
--name, -n De naam van de functie.
--template, -t Gebruik de func templates list opdracht om de volledige lijst met beschikbare sjablonen voor elke ondersteunde taal weer te geven.

Zie Een functie maken voor meer informatie.

func pack

Hiermee maakt u een implementatiepakket dat uw projectcode in een uitvoerbare status bevat. Gebruik deze methode wanneer u handmatig een implementatiepakket moet maken voor uw app op uw lokale computer buiten de func azure functionapp publish opdracht. Bouwt uw project standaard func pack wanneer dat nodig is.

func pack

Voer func pack deze uit in de map die het host.json projectbestand bevat. Dit is de hoofdmap van uw app. Het gegenereerde uitvoerbestand (.zip) heeft dezelfde naam als de map die u inpakt. Als er al een .zip bestand met die naam bestaat, wordt het eerst verwijderd en vervolgens vervangen door een bijgewerkte versie.

func pack Bouwt en verpakt standaard het Functions-project in de map waarin het wordt uitgevoerd. U kunt uitvoeren func pack om een andere map te verpakken door het pad naar de hoofdmap van het project in te stellen na de opdracht, zoals func pack ./myprojectroot. Wanneer de map waarop func pack wordt uitgevoerd geen bestand bevat host.json , wordt er een fout geretourneerd.

Bouwt standaard func pack alle projecten en installeert afhankelijkheden voor alle talen. Gebruik de --no-build en --skip-install opties om dit gedrag te wijzigen.

Belangrijk

Python-app-pakketten die zijn gebouwd op een Windows-computer hebben vaak problemen met het implementeren en uitvoeren op Linux in Azure Functions. Overweeg het gebruik --no-build met een externe build of --build-native-deps wanneer u wordt uitgevoerd func pack voor een Python-app in Windows.

De func pack actie ondersteunt deze opties:

Optie Beschrijving
--output Hiermee stelt u een pad in naar de locatie waarin het pakketbestand voor de implementatie .zip wordt gemaakt.
--no-build Project is niet gebouwd voordat het inpakt. Gebruik voor C#-apps alleen wanneer u uw binaire bestanden al hebt gegenereerd. Voor Node.js apps worden beide npm install en npm run build overgeslagen. U kunt deze optie gebruiken bij het aanvragen van een externe build op de inhoud van het pakket.
--skip-install Wordt overgeslagen npm install bij het inpakken van Node.jsfunctie-app op basis van een functie. Gebruik deze optie om te voorkomen dat aangepaste NPM-modules worden overschreven.
--build-native-deps Installeert Python-afhankelijkheden lokaal met behulp van een installatiekopieën die overeenkomen met de omgeving die wordt gebruikt in Azure. Hiervoor zijn Docker-hulpprogramma's vereist. Indien ingeschakeld, start Core Tools een Docker-container, bouwt u de app in die container en maakt u een .zip-bestand met alle afhankelijkheden die zijn hersteld in .python_packages. Gebruik deze optie bij het uitvoeren van Windows als een manier om potentiële bibliotheekproblemen te voorkomen wanneer deze in Linux in Azure worden geïmplementeerd.

func run

Alleen versie 1.x.

Gebruik deze opdracht om een functie rechtstreeks aan te roepen. Deze opdracht werkt als het uitvoeren van een functie met behulp van het tabblad Testen in Azure Portal. Deze opdracht werkt alleen in versie 1.x. Voor latere versies gebruikt func start en roept u het functie-eindpunt rechtstreeks aan.

func run

De func run opdracht ondersteunt de volgende opties:

Optie Beschrijving
--content Inline-inhoud doorgegeven aan de functie.
--debug Koppel een foutopsporingsprogramma aan het hostproces voordat u de functie uitvoert.
--file De bestandsnaam die moet worden gebruikt als inhoud.
--no-interactive Er wordt niet om invoer gevraagd. Dit is handig voor automatiseringsscenario's.
--timeout Tijd die moet worden gewacht (in seconden) totdat de lokale Functions-host gereed is.

Als u bijvoorbeeld een door HTTP geactiveerde functie wilt aanroepen en de hoofdtekst van de inhoud wilt doorgeven, voert u de volgende opdracht uit:

func run MyHttpTrigger --content '{\"name\": \"Azure\"}'

func start

Start de lokale runtimehost en laadt het functieproject in de huidige map.

De specifieke opdracht is afhankelijk van de runtimeversie.

func start

func start ondersteunt de volgende opties:

Optie Beschrijving
--cert Het pad naar een PFX-bestand dat een persoonlijke sleutel bevat. Alleen ondersteund met --useHttps.
--cors Een door komma's gescheiden lijst met CORS-oorsprongen, zonder spaties.
--cors-credentials Sta geverifieerde aanvragen voor cross-origin toe met behulp van cookies en de verificatieheader.
--dotnet-isolated-debug Als dit is ingesteld true, wordt het .NET-werkproces onderbroken totdat een foutopsporingsprogramma is gekoppeld aan het geïsoleerde .NET-project dat wordt opgespoord.
--enable-json-output Verzendt waar mogelijk consolelogboeken als JSON.
--enableAuth Schakel de pijplijn voor volledige verificatieafhandeling in, met autorisatievereisten.
--functions Een door spaties gescheiden lijst met functies die moeten worden geladen.
--language-worker Argumenten voor het configureren van de taalwerker. U kunt bijvoorbeeld foutopsporing inschakelen voor taalwerkrol door foutopsporingspoort en andere vereiste argumenten op te geven.
--no-build Bouw het huidige project niet voordat u het uitvoert. Alleen voor .NET-klasseprojecten. De standaardwaarde is false.
--password Het wachtwoord of een bestand dat het wachtwoord voor een PFX-bestand bevat. Alleen gebruikt met --cert.
--port De lokale poort waarop moet worden geluisterd. Standaardwaarde: 7071.
--timeout De time-out voor de Functions-host die in seconden moet worden gestart. Standaard: 20 seconden.
--useHttps Binden aan https://localhost:{port} in plaats van aan http://localhost:{port}. Met deze optie maakt u standaard een vertrouwd certificaat op uw computer.

Wanneer het project wordt uitgevoerd, kunt u afzonderlijke functie-eindpunten verifiëren.

func azure functionapp algemene opties

Alle func azure functionapp opdrachten ondersteunen deze opties:

Optie Beschrijving
--slot Richt u op een specifieke benoemde implementatiesite, indien geconfigureerd.
--access-token Geef een toegangstoken op, behalve het standaardtoken, dat moet worden gebruikt voor het uitvoeren van geverifieerde acties in Azure.
--access-token-stdin Lees een specifiek toegangstoken uit een standaardinvoer. Gebruik deze optie bij het lezen van het token rechtstreeks vanuit een vorige opdracht, zoals az account get-access-token.
--management-url Stel de beheer-URL in voor de Azure-cloud, die standaard wordt ingesteld op https://management.azure.com. Gebruik deze optie wanneer uw functie-app wordt uitgevoerd in een onafhankelijke cloud.
--subscription Stel het standaardAbonnement voor Azure in.

func azure functionapp fetch-app-settings

Hiermee haalt u instellingen op van een specifieke functie-app.

func azure functionapp fetch-app-settings <APP_NAME>

Zie Toepassingsinstellingen downloaden voor meer informatie.

Met de opdracht worden instellingen gedownload naar het local.settings.json bestand voor het project. Met de opdracht worden waarden op het scherm gemaskeerd voor beveiliging. U kunt instellingen in het local.settings.json bestand beveiligen door lokale versleuteling in te schakelen.

func azure functionapp list-functions

Retourneert een lijst met de functies in de opgegeven functie-app.

func azure functionapp list-functions <APP_NAME>
Optie Beschrijving
--show-keys De url's van het functie-eindpunt die worden geretourneerd, bevatten waarden voor toegangssleutels op functieniveau.

func azure functionapp logstream

Verbindt de lokale opdrachtprompt met streaminglogboeken voor de functie-app in Azure.

func azure functionapp logstream <APP_NAME>

De standaardtime-out voor de verbinding is twee uur. U kunt de time-out wijzigen door een app-instelling met de naam SCM_LOGSTREAM_TIMEOUT toe te voegen, met een time-outwaarde in seconden. Deze functie wordt nog niet ondersteund voor Linux in een Flex Consumption - of Consumption-abonnement . Gebruik voor deze apps de --browser optie om logboeken in de portal weer te geven.

De deploy actie ondersteunt de volgende opties:

Optie Beschrijving
--browser Open Azure-toepassing Insights Live Stream voor de functie-app in de standaardbrowser.

Zie Logboeken voor streaming-uitvoering inschakelen in Azure Functions voor meer informatie.

func azure functionapp publish

Implementeert een Functions-project naar een bestaande functie-app-resource in Azure.

func azure functionapp publish <APP_NAME>

Zie Projectbestanden implementeren voor meer informatie.

De volgende publicatieopties zijn van toepassing op basis van versie:

Optie Beschrijving
--additional-packages Lijst met pakketten die moeten worden geïnstalleerd bij het bouwen van systeemeigen afhankelijkheden. Voorbeeld: python3-dev libevent-dev.
--build, -b Hiermee wordt een buildactie uitgevoerd bij het implementeren naar een Linux-functie-app. Accepteert: remote en local.
--build-native-deps Hiermee wordt het genereren van de map overgeslagen bij het .wheels publiceren van Python-functie-apps.
--csx Publiceer een C#-scriptproject (.csx).
--dotnet-cli-params Bij het publiceren van gecompileerde C#-functies (.csproj) worden de belangrijkste hulpprogramma's aangeroepen dotnet build --output bin/publish. Alle parameters die hieraan worden doorgegeven, worden toegevoegd aan de opdrachtregel.
--force Verificatie vooraf publiceren negeren in bepaalde scenario's.
--list-ignored-files Geeft een lijst weer met bestanden die tijdens het publiceren worden genegeerd. Dit is gebaseerd op het .funcignore bestand.
--list-included-files Geeft een lijst weer met bestanden die zijn gepubliceerd, die zijn gebaseerd op het .funcignore bestand.
--no-build Project is niet gebouwd tijdens het publiceren. Voor Python pip install wordt dit niet uitgevoerd.
--nozip Hiermee schakelt u de standaardmodus Run-From-Package uit.
--overwrite-settings -y Onderdrukt de prompt om app-instellingen te overschrijven wanneer --publish-local-settings -i deze wordt gebruikt.
--publish-local-settings -i Publiceer instellingen in local.settings.json naar Azure en vraag om te overschrijven als de instelling al bestaat. Als u een lokale opslagemulator gebruikt, wijzigt u eerst de app-instelling in een werkelijke opslagverbinding.
--publish-settings-only, -o Publiceer alleen instellingen en sla de inhoud over. De standaardinstelling is een prompt.

func azure storage fetch-connection-string

Hiermee haalt u de verbindingsreeks op voor het opgegeven Azure Storage-account.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Zie Een opslag verbindingsreeks downloaden voor meer informatie.

func azurecontainerapps deploy

Implementeert een functie-app in een container in een Azure Container Apps-omgeving. Zowel het opslagaccount dat door de functie-app als de omgeving wordt gebruikt, moet al bestaan. Zie Azure Container Apps die als host fungeren voor Azure Functions voor meer informatie.

func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> --registry-server <REGISTRY_SERVER> --registry-username <USERNAME> --registry-password <PASSWORD>

De volgende implementatieopties zijn van toepassing:

Optie Beschrijving
--environment De naam van een bestaande Container Apps-omgeving.
--image-build Als dit is ingesteld true, wordt de lokale Docker-build overgeslagen.
--image-name De installatiekopieënnaam van een bestaande container in een containerregister. De naam van de installatiekopieën bevat de tagnaam.
--location Regio voor de implementatie. Idealiter is deze regio dezelfde regio als de resources voor de omgeving en het opslagaccount.
--name De naam die wordt gebruikt voor de implementatie van de functie-app in de Container Apps-omgeving. Dezelfde naam wordt ook gebruikt bij het beheren van de functie-app in de portal. De naam moet uniek zijn in de omgeving.
--registry Wanneer deze is ingesteld, wordt een Docker-build uitgevoerd en wordt de installatiekopieën naar de registerset gepusht.--registry U kunt niet gebruiken --registry met --image-name. Gebruik ook --registry-usernamevoor Docker Hub.
--registry-password Het wachtwoord of token dat wordt gebruikt om de installatiekopieën op te halen uit een privéregister.
--registry-username De gebruikersnaam die wordt gebruikt om de installatiekopieën op te halen uit een privéregister.
--resource-group De resourcegroep waarin de functies gerelateerde resources moeten worden gemaakt.
--storage-account De verbindingsreeks voor het opslagaccount dat moet worden gebruikt door de functie-app.
--worker-runtime Hiermee stelt u de runtimetaal van de functie-app in. Deze parameter wordt alleen gebruikt met --image-name en --image-build. Anders wordt de taal bepaald tijdens de lokale build. Ondersteunde waarden zijn: dotnet, dotnetIsolated, node, python, , en powershellcustom(voor handlers van klanten).

Belangrijk

Opslag verbindingsreeks s en andere servicereferenties zijn belangrijke geheimen. Zorg ervoor dat u alle scriptbestanden die worden gebruikt func azurecontainerapps deploy , veilig opslaat en deze niet opslaat in een openbaar toegankelijk broncodebeheer.

func deploy

De func deploy opdracht is afgeschaft. Gebruik in plaats daarvan func kubernetes deploy.

func durable delete-task-hub

Hiermee verwijdert u alle opslagartefacten in de Durable Functions-taakhub.

func durable delete-task-hub

De delete-task-hub actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--task-hub-name Optionele naam van de Durable Task Hub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable get-history

Retourneert de geschiedenis van het opgegeven orchestration-exemplaar.

func durable get-history --id <INSTANCE_ID>

De get-history actie ondersteunt de volgende opties:

Optie Beschrijving
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--task-hub-name Optionele naam van de Durable Task Hub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable get-instances

Retourneert de status van alle indelingsexemplaren. Ondersteunt paging met behulp van de top parameter.

func durable get-instances

De get-instances actie ondersteunt de volgende opties:

Optie Beschrijving
--continuation-token Optioneel token dat een specifieke pagina of sectie aangeeft van de aanvragen die moeten worden geretourneerd.
--connection-string-setting Optionele naam van de app-instelling die de opslag-verbindingsreeks bevat die u wilt gebruiken.
--created-after U kunt eventueel de exemplaren ophalen die na deze datum en tijd (UTC) zijn gemaakt. Alle ISO 8601-indelingen voor datum/tijd worden geaccepteerd.
--created-before U kunt eventueel de exemplaren ophalen die zijn gemaakt vóór een specifieke datum en tijd (UTC). Alle ISO 8601-indelingen voor datum/tijd worden geaccepteerd.
--runtime-status U kunt desgewenst de exemplaren ophalen waarvan de status overeenkomt met een specifieke status, inclusief running, completeden failed. U kunt een of meer door spaties gescheiden statussen opgeven.
--top Beperk eventueel het aantal records dat wordt geretourneerd in een bepaalde aanvraag.
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable get-runtime-status

Retourneert de status van het opgegeven orchestration-exemplaar.

func durable get-runtime-status --id <INSTANCE_ID>

De get-runtime-status actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--show-input Wanneer dit is ingesteld, bevat het antwoord de invoer van de functie.
--show-output Wanneer dit is ingesteld, bevat het antwoord de uitvoeringsgeschiedenis.
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable purge-history

De instantiestatus, geschiedenis en blobopslag opschonen voor indelingen die ouder zijn dan de opgegeven drempelwaarde.

func durable purge-history

De purge-history actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--created-after Verwijder eventueel de geschiedenis van exemplaren die na deze datum/tijd (UTC) zijn gemaakt. Alle ISO 8601 opgemaakte datum/tijd-waarden worden geaccepteerd.
--created-before Verwijder eventueel de geschiedenis van exemplaren die vóór deze datum/tijd (UTC) zijn gemaakt. Alle ISO 8601 opgemaakte datum/tijd-waarden worden geaccepteerd.
--runtime-status Verwijder desgewenst de geschiedenis van exemplaren waarvan de status overeenkomt met een specifieke status, inclusief completed, terminated, canceleden failed. U kunt een of meer door spaties gescheiden statussen opgeven. Als u dit niet opneemt --runtime-status, wordt de exemplaargeschiedenis verwijderd, ongeacht de status.
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable raise-event

Hiermee wordt een gebeurtenis gegenereerd voor het opgegeven orchestration-exemplaar.

func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>

De raise-event actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--event-data Gegevens die moeten worden doorgegeven aan de gebeurtenis, hetzij inline of uit een JSON-bestand (vereist). Voor bestanden moet u het pad naar het bestand vooraf laten gaan met een ampersand (@zoals @path/to/file.json.
--event-name Naam van de gebeurtenis die moet worden gegenereerd (vereist).
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable rewind

Hiermee wordt het opgegeven indelingsexemplaar terugspoelen.

func durable rewind --id <INSTANCE_ID> --reason <REASON>

De rewind actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--reason Reden voor het terugspoelen van de indeling (vereist).
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable start-new

Hiermee start u een nieuw exemplaar van de opgegeven orchestratorfunctie.

func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>

De start-new actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--function-name Naam van de orchestratorfunctie die moet worden gestart (vereist).
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--input Invoer voor de orchestratorfunctie, inline of vanuit een JSON-bestand (vereist). Voor bestanden moet u het pad naar het bestand vooraf laten gaan met een ampersand (@zoals @path/to/file.json.
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func durable terminate

Hiermee stopt u het opgegeven indelingsexemplaar.

func durable terminate --id <INSTANCE_ID> --reason <REASON>

De terminate actie ondersteunt de volgende opties:

Optie Beschrijving
--connection-string-setting Optionele naam van de instelling met de opslag verbindingsreeks te gebruiken.
--id Hiermee geeft u de id van een indelingsinstantie (vereist).
--reason Reden voor het stoppen van de indeling (vereist).
--task-hub-name Optionele naam van de Durable Functions-taakhub die moet worden gebruikt.

Zie de Durable Functions-documentatie voor meer informatie.

func extensions install

Hiermee worden Functions-extensies handmatig geïnstalleerd in een non-.NET project of in een C#-scriptproject.

func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>

De install actie ondersteunt de volgende opties:

Optie Beschrijving
--configPath Pad naar de map met extensions.csproj-bestand.
--csx Ondersteunt C#-scriptprojecten (.csx).
--force Werk de versies van bestaande extensies bij.
--output Uitvoerpad voor de extensies.
--package Id voor een specifiek uitbreidingspakket. Wanneer dit niet is opgegeven, worden alle extensies waarnaar wordt verwezen, zoals bij func extensions sync.
--source NuGet-feedbron wanneer u NuGet.org niet gebruikt.
--version Versie van extensiepakket.

In het volgende voorbeeld wordt versie 5.0.1 van de Event Hubs-extensie in het lokale project geïnstalleerd:

func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1

De volgende overwegingen zijn van toepassing bij gebruik func extensions install:

  • Voor gecompileerde C#-projecten (zowel in-process als geïsoleerd werkproces) gebruikt u in plaats daarvan standaard NuGet-pakketinstallatiemethoden, zoals dotnet add package.

  • Als u extensies handmatig wilt installeren met behulp van Core Tools, moet de .NET SDK zijn geïnstalleerd.

  • Gebruik indien mogelijk extensiebundels. Hier volgen enkele redenen waarom u extensies mogelijk handmatig moet installeren:

    • U moet toegang krijgen tot een specifieke versie van een extensie die niet beschikbaar is in een bundel.
    • U moet toegang krijgen tot een aangepaste extensie die niet beschikbaar is in een bundel.
    • U moet toegang krijgen tot een specifieke combinatie van extensies die niet beschikbaar zijn in één bundel.

  • Voordat u extensies handmatig kunt installeren, moet u eerst het extensionBundle object verwijderen uit het host.json-bestand dat de bundel definieert. Er wordt geen actie ondernomen wanneer een extensiebundel al is ingesteld in uw host.json-bestand.

  • De eerste keer dat u expliciet een extensie installeert, wordt een .NET-projectbestand met de naam extensions.csproj toegevoegd aan de hoofdmap van uw app-project. Dit bestand definieert de set NuGet-pakketten die vereist zijn voor uw functies. Hoewel u met de NuGet-pakketverwijzingen in dit bestand kunt werken, kunt u met Core Tools extensies installeren zonder dat u dit C#-projectbestand handmatig hoeft te bewerken.

func extensions sync

Installeert alle extensies die u aan de functie-app toevoegt.

De sync actie ondersteunt de volgende opties:

Optie Beschrijving
--configPath Pad naar de map met extensions.csproj-bestand.
--csx Ondersteunt C#-scriptprojecten (.csx).
--output Uitvoerpad voor de extensies.

Hiermee wordt een ontbrekend extensions.csproj-bestand opnieuw gegenereerd. Als u een extensiebundel in uw host.json-bestand definieert, wordt er geen actie ondernomen.

func kubernetes deploy

Hiermee wordt een Functions-project geïmplementeerd als een aangepaste Docker-container in een Kubernetes-cluster.

func kubernetes deploy

Met deze opdracht wordt uw project gebouwd als een aangepaste container en gepubliceerd naar een Kubernetes-cluster. Aangepaste containers moeten een Dockerfile hebben. Als u een app wilt maken met een Dockerfile, gebruikt u de --dockerfile optie met de func init opdracht.

De volgende Kubernetes-implementatieopties zijn beschikbaar:

Optie Beschrijving
--dry-run U kunt eventueel de implementatiesjabloon weergeven zonder uitvoering.
--config-map-name Optionele naam van een bestaande configuratietoewijzing met functie-app-instellingen die in de implementatie moeten worden gebruikt. Vereist --use-config-map. Het standaardgedrag is het maken van instellingen op basis van het Values object in het local.settings.json-bestand.
--cooldown-period De afkoelperiode (in seconden) nadat alle triggers niet meer actief zijn voordat de implementatie omlaag wordt geschaald naar nul, met een standaardwaarde van 300 s.
--ignore-errors Hiermee wordt de implementatie voortgezet nadat een resource een fout heeft geretourneerd. Het standaardgedrag is om de fout te stoppen.
--image-name De naam van de installatiekopieën die moeten worden gebruikt voor de podimplementatie en van waaruit functies moeten worden gelezen.
--keda-version Hiermee stelt u de keda-versie in die moet worden geïnstalleerd. Geldige opties zijn: v1 en v2 (standaard).
--keys-secret-name De naam van een Kubernetes Secrets-verzameling die moet worden gebruikt voor het opslaan van toegangssleutels.
--max-replicas Hiermee stelt u het maximumaantal replica's in waarvoor de horizontale schaalaanpassing van pods (HPA) wordt geschaald.
--min-replicas Hiermee stelt u het minimale aantal replica's in waaronder HPA niet wordt geschaald.
--mount-funckeys-as-containervolume Koppelt de toegangssleutels als een containervolume.
--name De naam die wordt gebruikt voor de implementatie en andere artefacten in Kubernetes.
--namespace Hiermee stelt u de Kubernetes-naamruimte in waarop moet worden geïmplementeerd. Deze wordt standaard ingesteld op de standaardnaamruimte.
--no-docker Functies worden gelezen uit de huidige map in plaats van uit een afbeelding. Vereist het koppelen van het bestandssysteem van de installatiekopieën.
--registry Wanneer deze is ingesteld, wordt een Docker-build uitgevoerd en wordt de installatiekopieën naar een register met die naam gepusht. U kunt niet gebruiken --registry met --image-name. Gebruik uw gebruikersnaam voor Docker.
--polling-interval Het polling-interval (in seconden) voor het controleren van niet-HTTP-triggers, met een standaardwaarde van 30.
--pull-secret Het geheim dat wordt gebruikt voor toegang tot persoonlijke registerreferenties.
--secret-name De naam van een bestaande Kubernetes Secrets-verzameling die functie-app-instellingen bevat die in de implementatie moeten worden gebruikt. Het standaardgedrag is het maken van instellingen op basis van het Values object in het local.settings.json-bestand.
--show-service-fqdn Geeft de URL's van HTTP-triggers weer met de Kubernetes FQDN in plaats van het standaardgedrag van het gebruik van een IP-adres.
--service-type Hiermee stelt u het type Kubernetes Service in. Ondersteunde waarden zijn: ClusterIP, NodePorten LoadBalancer (standaard).
--use-config-map Gebruik een ConfigMap object (v1) in plaats van een Secret object (v1) om instellingen voor functie-apps te configureren. De kaartnaam wordt ingesteld met behulp van --config-map-name.

Core Tools maakt gebruik van de lokale Docker CLI om de installatiekopieën te bouwen en te publiceren. Zorg ervoor dat Docker al lokaal is geïnstalleerd. Voer de docker login opdracht uit om verbinding te maken met uw account.

Azure Functions biedt ondersteuning voor het hosten van uw containerfuncties in Azure Container Apps of in Azure Functions. Het rechtstreeks uitvoeren van uw containers in een Kubernetes-cluster of in Azure Kubernetes Service (AKS) wordt niet officieel ondersteund door Azure Functions. Zie ondersteuning voor Linux-containers in Azure Functions voor meer informatie.

func kubernetes install

Hiermee installeert u KEDA in een Kubernetes-cluster.

func kubernetes install

Hiermee wordt KEDA geïnstalleerd op het cluster dat is gedefinieerd in het kubectl-configuratiebestand.

De install actie ondersteunt de volgende opties:

Optie Beschrijving
--dry-run Geeft de implementatiesjabloon weer zonder uitvoering.
--keda-version Hiermee stelt u de keda-versie in die moet worden geïnstalleerd. Geldige opties zijn: v1 en v2 (standaard).
--namespace Ondersteunt de installatie van een specifieke Kubernetes-naamruimte. Als deze niet is ingesteld, wordt de standaardnaamruimte gebruikt.

Zie Keda en functies beheren in Kubernetes voor meer informatie.

func kubernetes remove

Hiermee verwijdert u KEDA uit het Kubernetes-cluster dat is gedefinieerd in het kubectl-configuratiebestand.

func kubernetes remove

Hiermee verwijdert u KEDA uit het cluster dat is gedefinieerd in het kubectl-configuratiebestand.

De remove actie ondersteunt de volgende opties:

Optie Beschrijving
--namespace Ondersteunt het verwijderen van een specifieke Kubernetes-naamruimte. Als deze niet is ingesteld, wordt de standaardnaamruimte gebruikt.

Zie KEDA verwijderen uit Kubernetes voor meer informatie.

func settings add

Voegt een nieuwe instelling toe aan de Values verzameling in het local.settings.json-bestand.

func settings add <SETTING_NAME> <VALUE>

Vervang <SETTING_NAME> door de naam van de app-instelling en <VALUE> door de waarde van de instelling.

De add actie ondersteunt de volgende optie:

Optie Beschrijving
--connectionString Voegt het naam-waardepaar toe aan de ConnectionStrings verzameling in plaats van de Values verzameling. Gebruik de ConnectionStrings verzameling alleen wanneer dit is vereist voor bepaalde frameworks. Zie local.settings.json bestand voor meer informatie.

func settings decrypt

Ontsleutelt eerder versleutelde waarden in de Values verzameling in het bestand local.settings.json.

func settings decrypt

Met de opdracht worden ook verbindingsreekswaarden in de ConnectionStrings verzameling ontsleuteld. In local.settings.jsonwordt de opdracht ingesteld IsEncrypted op false. Versleutel lokale instellingen om het risico te beperken dat waardevolle informatie uit local.settings.json wordt gelekt. In Azure worden toepassingsinstellingen altijd versleuteld opgeslagen.

func settings delete

Hiermee verwijdert u een bestaande instelling uit de Values verzameling in het local.settings.json-bestand.

func settings delete <SETTING_NAME>

Vervang <SETTING_NAME> door de naam van de app-instelling en <VALUE> door de waarde van de instelling.

De delete actie ondersteunt de volgende optie:

Optie Beschrijving
--connectionString Hiermee verwijdert u het naam-waardepaar uit de ConnectionStrings verzameling in plaats van uit de Values verzameling.

func settings encrypt

Versleutelt de waarden van afzonderlijke items in de Values verzameling in het bestand local.settings.json.

func settings encrypt

Met de opdracht worden ook verbindingsreekswaarden in de ConnectionStrings verzameling versleuteld. In local.settings.jsonwordt de opdracht ingesteld IsEncrypted op true, waarmee wordt aangegeven dat de lokale runtime instellingen ontsleutelt voordat deze worden gebruikt. Versleutel lokale instellingen om het risico te beperken dat waardevolle informatie uit local.settings.json wordt gelekt. In Azure worden toepassingsinstellingen altijd versleuteld opgeslagen.

func settings list

Hiermee wordt een lijst met instellingen in de Values verzameling in het local.settings.json-bestand uitgevoerd.

func settings list

Verbindingsreeksen uit de ConnectionStrings verzameling worden ook uitgevoerd. Standaard worden waarden gemaskeerd voor beveiliging. Gebruik de --showValue optie om de werkelijke waarde weer te geven.

De list actie ondersteunt de volgende optie:

Optie Beschrijving
--showValue Toont de werkelijke niet-ontmaskerde waarden in de uitvoer.

func templates list

Hiermee worden de beschikbare functiesjablonen (triggersjablonen) weergegeven.

De list actie ondersteunt de volgende optie:

Optie Beschrijving
--language Taal voor het filteren van geretourneerde sjablonen. Standaard wordt alle talen geretourneerd.
  • Last updated on