---
sourceDocument: Xanadu: Erstellen oder ändern Sie Anwendungen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/application-development

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu: Erstellen oder ändern Sie Anwendungen

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

# ServiceNow CLI

# ServiceNow CLI {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 Minuten Lesedauer

Verwenden Sie die Befehlszeilenschnittstelle (CLI) ServiceNow, um Changes zwischen einer lokalen Anwendung und der Anwendung in einer -Instanz zu verwalten.
Geben Sie im Befehlszeilentool auf Ihrem System `now-sdk` ein, um die CLI zu starten und eine Liste der verfügbaren Befehle zurückzugeben, oder `now-sdk [Befehl]`, um mit der Verwendung von ServiceNow\] zu beginnen.

Die CLI enthält die folgenden Befehle und globalen Optionen:
{#servicenow-sdk-cli-commands__table_ynq_2fh_jzb__entry__2}

| Option | Beschreibung |
|-|-|
| --version | Geben Sie die Version der CLI zurück. |
| --help, -h | Geben Sie Informationen zu Befehlen, Unterbefehlen und Parametern zurück. |
[Tabelle : 1. Globale Optionen]

{#servicenow-sdk-cli-commands__table_ynq_2fh_jzb}

## Upgrade {#ariaid-title2}

Führen Sie ein Upgrade auf die neueste Version von ServiceNow durch, um Instanzen des Release Xanadu zu verwenden.
Durch ein Upgrade von ServiceNow werden keine Anwendungen aktualisiert, die Sie zuvor mit ServiceNowerstellt oder konvertiert haben.  
Der Befehl zum `Aktualisieren` hat die folgende Struktur:

    now-sdk upgrade [--debug <flag>]

{#now-sdk-upgrade-command__table_vx2_vvr_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| --debug, -d | Boolean | Eine Option zum Zurückgeben der während des Upgrade-Vorgangs generierten Debug-Protokolle. | falsch |
[Tabelle : 2. Optionale Parameter]

{#now-sdk-upgrade-command__table_vx2_vvr_rzb}  
Beispiel:

    now-sdk upgrade --debug true

## Authentifizierung {#ariaid-title3}

Authentifizieren Sie sich bei einer -Instanz, und speichern, aktualisieren oder zeigen Sie Anwenderanmeldeinformationen für den Zugriff auf eine Instanz in Ihrem System an.
Der Befehl `auth` weist die Unterbefehle `save`, `löschen`, `list`und `set-default auf` und weist folgende Struktur auf:

    now-sdk auth [<subcommand>]

### Speichern {#now-sdk-auth-command__section_kkt_dml_rzb}

Speichern Sie die Anmeldeinformationen im Geräteschlüsselbund oder im Anmeldeinformationsmanager auf Ihrem System. Geben Sie bei Aufforderung ein Passwort ein, um sich bei der Instanz zu authentifizieren.  
Der Unterbefehl `speichern` hat die folgende Struktur:

    now-sdk auth save [<alias>] [--host <hostname>] [--username <username>] [--default]

{#now-sdk-auth-command__table_udn_jml_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| alias | Zeichenfolge | Ein eindeutiger Bezeichner für die Host- und Anwenderanmeldeinformationen. Der Alias kann für die Authentifizierung mit den Befehlen `create`, `konvertieren`, `abrufen`und `bereitstellen` verwendet werden. | --- |
| --host | Zeichenfolge | Die Zielinstanz, auf die zugegriffen werden soll und für die Sie Anwendungen bereitstellen und abrufen. Die Instanz muss sich im Release Xanadu befinden. | --- |
| --username | Zeichenfolge | Ein Now Platform -Anwendername für die Authentifizierung bei der -Instanz. Der Anwender muss über Administratorzugriff verfügen. | --- |
[Tabelle : 3. Erforderliche Parameter]

{#now-sdk-auth-command__table_udn_jml_rzb} {#now-sdk-auth-command__table_wdn_jml_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| --default, -d | Boolean | Option zum Festlegen des `Alias` als Standardalias. | falsch |
[Tabelle : 4. Optionale Parameter]

{#now-sdk-auth-command__table_wdn_jml_rzb}

Beispiel:

    now-sdk auth save devuser1 --host https://myinstance.service-now.com --username user1 --default

### leeren {#now-sdk-auth-command__section_rgz_dml_rzb}

Entfernen Sie die Anmeldeinformationen im Geräteschlüsselbund oder im Anmeldeinformationsmanager auf Ihrem System.  
Der Unterbefehl zum `Löschen` hat die folgende Struktur:

    now-sdk auth clear [<alias>]

{#now-sdk-auth-command__table_vvj_c2r_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| alias | Zeichenfolge | Ein eindeutiger Bezeichner für die Host- und Anwenderanmeldeinformationen. | alle |
[Tabelle : 5. Optionale Parameter]

{#now-sdk-auth-command__table_vvj_c2r_rzb}  
Beispiel:

    now-sdk auth clear devuser1

### Liste {#now-sdk-auth-command__section_iqs_2ml_rzb}

Zeigen Sie die im Geräteschlüsselbund oder im Anmeldeinformationsmanager Ihres Systems gespeicherten Anmeldeinformationen an. Passwörter werden nicht zurückgegeben.  
Der Unterbefehl `list` hat die folgende Struktur:

    now-sdk auth list [<alias>]

{#now-sdk-auth-command__table_pkb_n2r_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| alias | Zeichenfolge | Ein eindeutiger Bezeichner für die Host- und Anwenderanmeldeinformationen. | alle |
[Tabelle : 6. Optionale Parameter]

{#now-sdk-auth-command__table_pkb_n2r_rzb}  
Beispiel:

    now-sdk auth list devuser1

### set-default {#now-sdk-auth-command__section_zbs_fml_rzb}

Legen Sie die Anmeldeinformationen fest, die standardmäßig von Befehlen verwendet werden sollen.  
Der Unterbefehl „ `set-default` " hat die folgende Struktur:

    now-sdk auth set-default [<alias>]

{#now-sdk-auth-command__table_ok3_r2r_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| alias | Zeichenfolge | Ein eindeutiger Bezeichner für die Host- und Anwenderanmeldeinformationen. | --- |
[Tabelle : 7. Erforderliche Parameter]

{#now-sdk-auth-command__table_ok3_r2r_rzb}  
Beispiel:

    now-sdk auth set-default devuser1

## Erstellen {#ariaid-title4}

Erstellen Sie eine anwenderdefinierte bereichsbezogene Anwendung, und stellen Sie sie, falls angegeben, in einer Instanz bereit.
Der Befehl `create` weist die folgende Struktur auf:

    now-sdk create <scopeName> <directory> [--appName <name>] [--packageName <name>] [--description <description>] [--sampleTable <flag>] [--offline <flag>] [--auth <alias>] [--interactive <flag>] [--open-browser <flag>] [--projectType <type>] [--template <type>]

{#now-sdk-create-command__table_lfx_51l_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| scopeName | Zeichenfolge | Umfang der Anwendung. Der Bereichsname muss für die Instanz eindeutig sein und mit x_ beginnen.\<prefix\> , und weniger als 12 Zeichen lang sein. Weitere Informationen finden Sie unter [Namespace-Identifier](https://servicenow-prod.fluidtopics.net/xDi83h2cKD2jJCeWB8_JrQ "Das System fügt vor Anwendungsartefakten wie Tabellen, Skripts und Konfigurationsdatensätzen einen Namespace-Identifier hinzu."). | --- |
| Verzeichnis | Zeichenfolge | Das lokale Verzeichnis, in dem die Anwendungsverzeichnisse und -dateien erstellt werden sollen. | Aktuelles Arbeitsverzeichnis |
[Tabelle : 8. Erforderliche Parameter]

{#now-sdk-create-command__table_lfx_51l_rzb} {#now-sdk-create-command__table_mfx_51l_rzb__entry__4}{#now-sdk-create-command__package-name}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| --appName | Zeichenfolge | Der Name der Anwendung. | --- |
| --packageName | Zeichenfolge | Ein Name für das Anwendungspaket, das in der Datei „package.json " verwendet wird. Der Paketname muss den NPM-Paketbenennungsstandards entsprechen. | --- |
| --description | Zeichenfolge | Eine Kurzbeschreibung Ihrer Anwendung. | --- |
| --sampleTable | Boolean | Eine Option zum Erstellen einer Beispieltabelle in der Anwendung. Bei „wahr" wird eine Beispieltabelle mit dem Namen\<scope\> _to_do wird erstellt. | falsch |
| --offline, -o | Boolean | Eine Option zum Überspringen der Bereitstellung einer Anwendung in der Instanz. Bei „wahr" wird der Bereichsname während der Erstellung nicht validiert. Sie müssen daher vor der Bereitstellung in Ihrer Instanz überprüfen, ob der Bereichsname gültig ist.​ Hinweis: Dieser Parameter wird ignoriert, wenn der `Auth` -Parameter festgelegt ist. | falsch |
| --auth, -a | Zeichenfolge | Ein Alias für die Anmeldeinformationen, die zur Authentifizierung bei der Instanz verwendet werden sollen. | Wenn festgelegt, der Standardalias. |
| --interactive, -i | Boolean | Eine Option zum Beantworten einer geführten Gruppe von Aufforderungen zum Erstellen der Anwendung. | falsch |
| --open-browser, -b | Boolean | Eine Option zum Öffnen des Anwendungsdatensatzes in Ihrem Standardbrowser, nachdem die Anwendung erfolgreich bereitgestellt wurde. Hinweis: Dieser Parameter wird ignoriert, wenn der `Offline` -Parameter auf „wahr" festgelegt ist. | falsch |
| --projectType | Zeichenfolge | Eine Option zum Angeben des Typs der zu erstellenden Anwendung. Diese Option bestimmt die Standardanwendungsstruktur basierend darauf, ob Sie ServiceNow Fluent und JavaScript-Module sowie Bibliotheken von Drittparteien in der Anwendung verwenden möchten (`fluk`) oder nur JavaScript-Module und Bibliotheken von Drittparteien (`module`). | fließend |
| --template, -t | Zeichenfolge | Eine Option zum Festlegen, ob JavaScript oder TypeScript in Modulen verwendet werden soll. Diese Option bestimmt die Konfiguration der Dateien „ package.json" und „now.config.json" und fügt eine tsconfig.json -Datei für TypeScript-Projekte hinzu. | Javascript |
[Tabelle : 9. Optionale Parameter]

{#now-sdk-create-command__table_mfx_51l_rzb}  
Beispiel:

    now-sdk create x_snc_example /path/to/app_folder --appName example-app --description example_app_description --sampleTable true --auth devuser1 --open-browser true --projectType fluent --template typescript

## convert {#ariaid-title5}

Konvertieren Sie eine vorhandene -Anwendung aus einer -Instanz so, dass das lokale Ändern der Anwendung in Visual Studio Code und das Bereitstellen von Anwendungs-Changes für die Instanz mit ServiceNowunterstützt werden.
Beim Konvertieren einer Anwendung werden die erforderlichen Dateien und Verzeichnisse für die lokale Verwendung von ServiceNow hinzugefügt und die Anwendungsmetadaten je nach Projekttyp als Quellcode ServiceNow Fluent oder als XML-Dateien heruntergeladen. Die Anwendung wird in der Instanz nicht geändert.  
Der Befehl zum `Konvertieren` hat die folgende Struktur:

    now-sdk convert <scopeName> <packageName> [<directory>] [--auth <alias>] [--projectType <type>] [--template <type>]

{#now-sdk-convert-command__table_sx4_gtr_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| scopeName | Zeichenfolge | Der Umfang der vorhandenen Anwendung. | --- |
| Paketname | Zeichenfolge |   | --- |
[Tabelle : 10. Erforderliche Parameter]

{#now-sdk-convert-command__table_sx4_gtr_rzb} {#now-sdk-convert-command__table_tx4_gtr_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| Verzeichnis | Zeichenfolge | Das lokale Verzeichnis, in dem die Anwendungsverzeichnisse und -dateien erstellt werden sollen. | Aktuelles Arbeitsverzeichnis |
| --auth, -a | Zeichenfolge | Ein Alias für die Anmeldeinformationen, die zur Authentifizierung bei der Instanz verwendet werden sollen. | Wenn festgelegt, der Standardalias. |
| --projectType | Zeichenfolge | Eine Option zum Angeben des Typs der zu erstellenden Anwendung. Diese Option bestimmt die Standardanwendungsstruktur basierend darauf, ob Sie ServiceNow Fluent und JavaScript-Module sowie Bibliotheken von Drittparteien in der Anwendung verwenden möchten (`fluk`) oder nur JavaScript-Module und Bibliotheken von Drittparteien (`module`). | fließend |
| --template, -t | Zeichenfolge | Eine Option zum Festlegen, ob JavaScript oder TypeScript in Modulen verwendet werden soll. Diese Option bestimmt die Konfiguration der Dateien „ package.json" und „now.config.json" und fügt eine tsconfig.json -Datei für TypeScript-Projekte hinzu. | Javascript |
[Tabelle : 11. Optionale Parameter]

{#now-sdk-convert-command__table_tx4_gtr_rzb}

Beispiel:

    now-sdk convert x_snc_example example-app /path/to/app_folder --auth user1-dev --projectType fluent --template typescript


## abrufen {#ariaid-title6}

Laden Sie Anwendungsmetadaten aus einer -Instanz herunter, und aktualisieren Sie den Quellcode und die Metadatendateien in Ihrer lokalen Anwendung entsprechend.
Updates für JavaScript-Module werden beim Abrufen von Anwendungsmetadaten aus Ihrer Instanz nicht berücksichtigt.  
Der `Abrufbefehl` hat die folgende Struktur:

    now-sdk fetch [--directory <package path>] [--auth <alias>] [--debug <flag>]

{#now-sdk-fetch-command__table_sbb_xds_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| --directory | Zeichenfolge | Der Pfad zu Ihrer Anwendung. | Aktuelles Arbeitsverzeichnis |
| --auth, -a | Zeichenfolge | Ein Alias für die Anmeldeinformationen, die zur Authentifizierung bei der Instanz verwendet werden sollen. | Wenn festgelegt, der Standardalias. |
| --debug, -d | Boolean | Eine Option zum Zurückgeben der während des Abrufvorgangs generierten Debug-Protokolle. | falsch |
[Tabelle : 12. Optionale Parameter]

{#now-sdk-fetch-command__table_sbb_xds_rzb}  
Beispiel:

    now-sdk fetch --auth devuser1 --directory /path/to/package --debug true

## Build {#ariaid-title7}

Kompilieren Sie Quelldateien, und generieren Sie ein bereitstellbares Paket. Bibliotheksabhängigkeiten von Drittparteien werden in XML-Dateien konvertiert, die mit der Anwendung installiert werden können.
Der `Build-` Befehl weist die folgende Struktur auf:

    now-sdk build <source> [--debug <flag>] [--generate-deletes <flag>] [--lint <flag>] [--optimize <flag>]

{#now-sdk-build-command__table_vx2_vvr_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| Quelle | Zeichenfolge | Der Pfad zur Datei „package.json " für Ihre Anwendung. Die „package.json "-Datei muss sich im Basisverzeichnis Ihrer Anwendung befinden. | Aktuelles Arbeitsverzeichnis |
| --debug, -d | Boolean | Eine Option zum Zurückgeben der während des Build-Prozesses generierten Debug-Protokolle. | falsch |
| --generate-deletes | Boolean | Eine Option zum Generieren von Löschdatensatzaktualisierungen für Dateien, die zwischen Builds entfernt wurden. | wahr |
| --lint | Boolean | Eine Option zum Linten von Quelldateien vor dem Erstellen. | wahr |
| --optimize, -o | Boolean | Eine Option zum Optimieren der Paketierung durch Wiederverwendung unveränderter abhängiger XML-Dateien. | wahr |
[Tabelle : 13. Optionale Parameter]

{#now-sdk-build-command__table_vx2_vvr_rzb}  
Beispiel:

    now-sdk build /path/to/package --debug true --generate-deletes true --lint true --optimize true

## bereitstellen {#ariaid-title8}

Stellen Sie eine Anwendung für eine Instanz bereit. Bevor Sie den Befehl „ `deploy` " verwenden, müssen Sie den Befehl „ `build` " verwenden, um ein bereitstellbares Paket zu generieren.
Der Befehl `„deploy` " weist die folgende Struktur auf:

    now-sdk deploy [--source <package path>] [--reinstall <flag>] [--auth <alias>] [--open-browser <flag>]

{#now-sdk-deploy-command__table_xh2_5hs_rzb__entry__4}

| Parameter | Typ | Beschreibung | Standardwert |
|-|-|-|-|
| --source | Zeichenfolge | Der Pfad zur Datei „package.json " für Ihre Anwendung. Die „package.json "-Datei muss sich im Basisverzeichnis Ihrer Anwendung befinden. | Aktuelles Arbeitsverzeichnis |
| --reinstall, -r | Boolean | Eine Option zum Deinstallieren und erneuten Installieren der Anwendung in einer Instanz, um sicherzustellen, dass die Metadaten in der Instanz mit den Metadaten im Bereitstellungspaket übereinstimmen. Warnung: Metadaten, die sich in der Instanz, aber nicht in Ihrer lokalen Anwendung befinden, werden entfernt. Wenn Sie frühere Versionen von Modulen in der Tabelle „EcmaScript-Modul" \[sys_module\] haben, die nicht benötigt werden, werden durch die Bereitstellung einer Anwendung mit dem Neuinstallationsparameter (`now-sdk deploy --reinstall true`) frühere Versionen der Module der Anwendung aus der Tabelle entfernt. | falsch |
| --auth, -a | Zeichenfolge | Ein Alias für die Anmeldeinformationen, die zur Authentifizierung bei der Instanz verwendet werden sollen. | Wenn festgelegt, der Standardalias. |
| --open-browser, b | Boolean | Eine Option zum Öffnen des Anwendungsdatensatzes in Ihrem Standardbrowser, nachdem die Anwendung erfolgreich bereitgestellt wurde. | falsch |
| --info, -i | Boolean | Eine Option zum Zurückgeben von Details zur letzten Bereitstellung dieser Anwendung, z. B. den Status und aktualisierte Datensätze. Wenn dieser Parameter verwendet wird, wird die Anwendung nicht bereitgestellt. | falsch |
[Tabelle : 14. Optionale Parameter]

{#now-sdk-deploy-command__table_xh2_5hs_rzb}  
Beispiel:

    now-sdk deploy --auth devuser1 --source /path/to/package --reinstall false --open-browser true