UiPath Documentation
uipath-cli
latest
false
UiPath-CLI-Benutzerhandbuch
Wichtig :
Dieser Inhalt wurde maschinell übersetzt. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

UIP-Anmeldestatus

Syntax und Optionen für „uip Login status“, der den aktuellen Authentifizierungsstatus ohne Aktualisierungstoken meldet.

uip login status meldet den aktuellen Authentifizierungsstatus: ob Sie angemeldet sind, welche Organisation und welcher Mandant ausgewählt sind und wann das Zugriffstoken abläuft. Es ist eine schreibgeschützte Prüfung der gespeicherten Sitzung – keine Token werden von diesem Befehl aktualisiert.

Verwenden Sie es in Skripts, um die Folgearbeit zu steuern, oder interaktiv, um zu bestätigen, an welchen Mandanten ein nachfolgender uip -Aufruf abzielen soll.

Zusammenfassung​

uip login status
uip login status

Dieser Befehl berücksichtigt die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Argumente​

Keine.

Optionen​

Keine.

Hinweis:

login status akzeptiert -f, --file <folder> nicht – es liest immer den Standardspeicherort für Anmeldeinformationen. Wenn Sie einen nicht standardmäßigen Ordner für Anmeldeinformationen verwenden, führen Sie den entsprechenden Befehl uip login ... in diesem Ordner erneut aus, bevor Sie den Status überprüfen.

Beispiele​

# Human-readable (default table output)
uip login status

# JSON for scripts
uip login status --output json
# Human-readable (default table output)
uip login status

# JSON for scripts
uip login status --output json

Datenform (--output json)​

{
  "Code": "LoginStatus",
  "Data": {
    "Status": "Logged in",
    "Identity": "jane.doe@example.com",
    "IdentityType": "User",
    "AuthFlow": "Interactive",
    "CredentialSource": "SavedLogin",
    "Organization": "my-org",
    "OrganizationId": "00000000-0000-0000-0000-000000000001",
    "Tenant": "DefaultTenant",
    "TenantId": "00000000-0000-0000-0000-000000000002",
    "Expiration Date": "2026-04-18T10:30:00Z"
  }
}
{
  "Code": "LoginStatus",
  "Data": {
    "Status": "Logged in",
    "Identity": "jane.doe@example.com",
    "IdentityType": "User",
    "AuthFlow": "Interactive",
    "CredentialSource": "SavedLogin",
    "Organization": "my-org",
    "OrganizationId": "00000000-0000-0000-0000-000000000001",
    "Tenant": "DefaultTenant",
    "TenantId": "00000000-0000-0000-0000-000000000002",
    "Expiration Date": "2026-04-18T10:30:00Z"
  }
}
  • Status – einer von Logged in oder Not logged in. Wenn Sie nicht angemeldet sind, werden die meisten folgenden Felder weggelassen und Organization/Tenant werden auf N/A zurückgesetzt.
  • Identity – der handelt: eine E-Mail-Adresse eines Benutzers für interaktive Sitzungen oder "External application <clientId>" für eine Client-Anmeldeinformationen-/Verbundsitzung. Wird weggelassen, wenn er nicht ermittelt werden kann.
  • IdentityType – "User" oder der Typ der externen App. Immer wenn Identity vorhanden ist.
  • AuthFlow – wie die Identität geprüft wurde: "Interactive", "ClientCredentials" oder "FederatedCredentials". Vorhanden, wenn bekannt.
  • CredentialSource – woher die Sitzung stammt: "Robot", "EnvironmentVariables", "SavedLogin" oder "N/A".
  • UserId / UserEmail / UserName / ClientId – zusätzliche Identitätsdetails, die jeweils nur vorhanden sind, wenn die zugrunde liegende Sitzung dieses Feld tatsächlich enthält.
  • Profile – Das aktive benannte Profil, wenn eines festgelegt ist und die Sitzung dateibasiert ist.
  • Organization – Organisationsname, wenn verfügbar; andernfalls die Organisations-ID.
  • OrganizationId – neben Organization vorhanden, wenn die ID separat vom Namen bekannt ist.
  • Tenant – Mandantenname, wenn verfügbar; andernfalls die Mandanten-ID. N/A wenn kein Mandant ausgewählt ist.
  • TenantId – neben Tenant vorhanden, wenn die ID separat vom Namen bekannt ist.
  • BaseUrl – die aufgelöste Identitäts-/API-Basis-URL, sofern bekannt.
  • Expiration Date – ISO-8601-Zeitstempel für den Ablauf des Zugriffstokens. Dies wird hier nicht aktualisiert; Ein späterer Toolaufruf aktualisiert das Token bei Bedarf.
  • Hint (optional) – Hinweistext, wenn die Authentifizierungsebene etwas zu erkennen ist – z. B. meldet eine undurchsichtige PAT-Sitzung "Token is opaque (not a JWT) - expiration and identity cannot be determined locally. Commands will fail with 401 once it is revoked or expired." anstelle eines Ablaufdatums.
  • Provider (veraltet) – eine Legacy-Version mit niedrigerer Genauigkeit von CredentialSource ("Robot"/"Environment"/"File"/"N/A"), die für eine Version für vorhandene Skripte beibehalten wird. Lesen Sie stattdessen CredentialSource; Provider wird entfernt.

Welche Felder genau angezeigt werden, hängt vom Authentifizierungsflow ab – eine PAT-/Umgebungsvariablensitzung hat z. B. kein Identity/AuthFlow (das Token hat keine Ansprüche, von denen sie abgeleitet werden können), aber CredentialSource und BaseUrl.

Fehlerverhalten​

Wenn die gespeicherte Sitzung nicht lesbar ist oder das Fallback für die Umgebungsvariable (UIPATH_CLI_*) unvollständig ist, gibt die CLI ein ConfigError aus. Das Feld Instructions leitet Sie zur richtigen Ursache:

  • Wenn Umgebungsvariablen verwendet werden, aber falsch konfiguriert sind, lesen Sie die Anweisungen "Check the UIPATH_CLI_* environment variables and re-run."
  • Andernfalls verweisen die Anweisungen auf den Anmeldeinformationsordner auf der Festplatte.

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben