SchemaExtensionCmd.exe
Das Programm SchemaExtensionCmd.exe unterstützt Sie beim Importieren von kundenspezifischen Schemaerweiterungen in eine One Identity Manager-Datenbank.
Auf Datenbanken mit einer Staging-Ebene Testumgebung oder Entwicklungssystem können Sie kundenspezifische Schemaerweiterungen mit dem Programm wieder entfernen.
Das Programm können Sie über die Kommandozeile ausführen. Das Programm benötigt eine Definitionsdatei (XML-Datei). Die Definitionsdatei erstellen Sie mit dem Programm . Ausführliche Informationen finden Sie im One Identity Manager Konfigurationshandbuch.
Aufrufsyntax
SchemaExtensionCmd.exe
/Conn="{Connection string}"
/Auth="{Authentication String}"
[/Definition="{Path to import definition file}"]
[-f]
[/LogLevel=Off|Fatal|Error|Info|Warn|Debug|Trace]
Tabelle 58: Parameter und Optionen des Programms
|
/Conn |
Verbindungsparameter zur Datenbank. Es ist ein Benutzer mit der minimalen Berechtigungsebene Konfigurationsbenutzer erforderlich.
Ausführliche Informationen zu den Berechtigungen finden Sie im One Identity Manager Installationshandbuch und im One Identity Manager Handbuch zur Autorisierung und Authentifizierung.
Alternativ kann der Name der Verbindung laut Registrierungsdatenbank HKEY_CURRENT_USER\Software\One Identity\One Identity Manager\Global\Connections eingetragen werden. |
|
/Auth |
Authentifizierungsdaten. Die Authentifizierungsdaten sind abhängig vom Authentifizierungsmodul. Ausführliche Informationen zu den One Identity Manager Authentifizierungsmodulen finden Sie im One Identity Manager Handbuch zur Autorisierung und Authentifizierung. |
| /Definition |
Pfad zur Definitionsdatei (XML-Datei).
Beispiel:
C:\Path\To\Definition.xml |
| /LogLevel |
(Optional) Umfang der Ausgaben zur Verarbeitung. Zulässige Werte sind:
-
Off: Keine Protokollierung.
-
Fatal: Es werden alle kritischen Fehlermeldungen aufgezeichnet.
-
Error: Es werden alle Fehlermeldungen aufgezeichnet.
-
Info: Es werden alle Informationen aufgezeichnet.
-
Warn: Es werden alle Warnungen aufgezeichnet.
-
Debug: Es erfolgt die Aufzeichnung von Debugger-Ausgaben. Diese Einstellung sollte nur zu Testzwecken verwendet werden.
-
Trace: Es erfolgt die Ausgabe sehr ausführlicher Informationen. Diese Einstellung sollte nur zu Analysezwecken verwendet werden. Das Protokoll wird schnell groß und unübersichtlich. |
|
-f |
(Optional) Ist der Parameter vorhanden, wird nicht auf die Verarbeitung von DBQueue Prozessor Aufträgen gewartet. Das kann zur Fehler führen, wenn Schemaerweiterungen erwartet werden, die zuvor durch den DBQueue Prozessor erzeugt werden müssen. |
|
-v |
(Optional) Aktivierung von erweiterten Informationen. |
|
-? | h |
Anzeige der Hilfe zum Programm. |
Beispiel:
SchemaExtensionCmd.exe
/Conn="Data Source=<Database server>;Initial Catalog=<Database name>;User ID=<Database user>;Password=<Password>"
/Auth=Module=DialogUserAccountBased
/Definition=CustomExtensions.xml
CryptoConfigCMD.exe
Das Programm CryptoConfigCMD.exe unterstützt die Verschlüsselung und Entschlüsselung der One Identity Manager-Datenbank. Das Programm können Sie über die Kommandozeile ausführen.
Aufrufsyntax
CryptoConfigCMD.exe
--conn={Connection string}
--auth={Authentication string}
[--mode=Encrypt|EncryptExisting|Decrypt]
[--private-key= {Path to private key}]
[-y]
Tabelle 59: Parameter und Optionen des Programms
|
--conn |
--connection|
-c |
Verbindungsparameter zur Datenbank. Es ist ein Benutzer mit der minimalen Berechtigungsebene Konfigurationsbenutzer erforderlich.
Ausführliche Informationen zu den Berechtigungen finden Sie im One Identity Manager Installationshandbuch und im One Identity Manager Handbuch zur Autorisierung und Authentifizierung.
Alternativ kann der Name der Verbindung laut Registrierungsdatenbank HKEY_CURRENT_USER\Software\One Identity\One Identity Manager\Global\Connections eingetragen werden. |
|
--auth |
--auth-props|-a |
Authentifizierungsdaten für die Installation. Die Authentifizierungsdaten sind abhängig vom Authentifizierungsmodul.
Ausführliche Informationen zu den Authentifizierungsmodulen finden Sie im One Identity Manager Handbuch zur Autorisierung und Authentifizierung. |
|
--mode |
-m |
(Optional) Auszuführender Modus. Zulässige Werte sind:
-
Encrypt: Erstellen eines neuen privaten Schlüssels und Verschlüsseln der Datenbank (Standard)
-
EncryptExisting: Verschlüsseln der Datenbank mit einem vorhandenen Schlüssel
-
Decrypt: Entschlüsseln der Datenbankwerte. |
|
--private-key |
-p |
Pfad zur Datei mit dem privaten Schlüssel.
Dieser Pfad darf bei der Verschlüsselung einer Datenbank nicht vorhanden sein. Der Schlüssel kann nach dem Verschlüsselungsvorgang unter diesem Pfad gefunden werden. Diese Schlüsseldatei muss beim Entschlüsseln der Datenbank vorhanden sein. |
|
-y |
|
(Optional) Ist der Parameter vorhanden, werden alle Sicherheitsabfragen mit Ja beantwortet. |
|
--verbose |
-v |
(Optional) Aktivierung von erweiterten Informationen. |
|
--help |
-h, -? |
Anzeige der Hilfe zum Programm. |
Parameterformate
Mehrstelligen Optionen können in folgenden Formen angegeben werden:
--conn="..."
--conn "..."
/conn="..."
/conn "..."
Einstellige Optionen können in folgenden Formen angegeben werden:
-c="..."
-c "..."
/c="..."
/c "..."
Schalter sind in diesem Formen erlaubt:
-R
/R
Beispiel: Verschlüsseln einer Datenbank mit einem neuen Schlüssel
CryptoConfigCMD.exe
--conn="Data Source=<Database server>;Initial Catalog=<Database name>; User ID=<Database user>; Password=<Password>"
--auth="Module=DialogUser;User=<User name>;Password=<Password>"
--private-key=C:\path\to\private.key
Beispiel: Verschlüsseln einer Datenbank mit einem vorhandenen Schlüssel
CryptoConfigCMD.exe
--conn="Data Source=<Database server>;Initial Catalog=<Database name>; User ID=<Database user>; Password=<Password>"
--auth="Module=DialogUser;User=<User name>;Password=<Password>"
--mode=EncryptExisting
Beispiel: Entschlüsseln einer Datenbank mit einem vorhandenen Schlüssel
CryptoConfigCMD.exe
--conn="Data Source=<Database server>;Initial Catalog=<Database name>; User ID=<Database user>; Password=<Password>"
--auth="Module=DialogUser;User=<User name>;Password=<Password>"
--mode=Decrypt
--private-key=C:\path\to\private.key
DBConsCheckCmd.exe
Das Programm DBConsCheckCmd.exe unterstützt die Ausführung von Konsistenzprüfungen. Das Programm können Sie über die Kommandozeile ausführen.
Im Gegensatz zu den Konsistenzprüfungen im Manager oder im Designer werden die Tabellentests und Objekttests immer auf den Daten des Anwendungsdatenmodells und Systemdatenmodells ausgeführt.
Aufrufsyntax
DBConsCheckCmd.exe
/Conn="{Connection string}"
/Auth="{Authentication String}"
[-l]
[-p]
[/LogLevel=Off|Fatal|Error|Info|Warn|Debug|Trace]
[/Resultfile="{File}"]
[/ResultIdToSkip="{Error ID}"]
[/ConsistencyType="{Type}"]
[/UidConsistencyCheck="{UID}"]
[-v]
Tabelle 60: Parameter und Optionen des Programms
|
/Conn |
Verbindungsparameter zur Datenbank. Es ist ein Benutzer mit der minimalen Berechtigungsebene Endbenutzer erforderlich. Einige Konsistenzprüfungen benötigen die Berechtigungsebene für Konfigurationsbenutzer oder administrative Benutzer.
Ausführliche Informationen zu den Berechtigungen finden Sie im One Identity Manager Installationshandbuch und im One Identity Manager Handbuch zur Autorisierung und Authentifizierung.
Alternativ kann der Name der Verbindung laut Registrierungsdatenbank HKEY_CURRENT_USER\Software\One Identity\One Identity Manager\Global\Connections eingetragen werden. |
|
/Auth |
Authentifizierungsdaten. Die Authentifizierungsdaten sind abhängig vom Authentifizierungsmodul. Ausführliche Informationen zu den One Identity Manager Authentifizierungsmodulen finden Sie im One Identity Manager Handbuch zur Autorisierung und Authentifizierung. |
|
-l |
Ausgabe einer Liste mit allen Konsistenzprüfungen, welche ausgeführt werden können. Nach der Ausgabe wird das Programm beendet. |
|
-p |
(Optional) Ist der Parameter vorhanden, wird der Verarbeitungsfortschritt angezeigt. |
|
-v |
(Optional) Aktivierung von erweiterten Informationen. |
|
-? | -h |
Anzeige der Hilfe zum Programm. |
|
/LogLevel |
(Optional) Umfang der Ausgaben zur Verarbeitung. Zulässige Werte sind:
-
Off: Keine Protokollierung.
-
Fatal: Es werden alle kritischen Fehlermeldungen aufgezeichnet.
-
Error: Es werden alle Fehlermeldungen aufgezeichnet.
-
Info: Es werden alle Informationen aufgezeichnet.
-
Warn: Es werden alle Warnungen aufgezeichnet.
-
Debug: Es erfolgt die Aufzeichnung von Debugger-Ausgaben. Diese Einstellung sollte nur zu Testzwecken verwendet werden.
-
Trace: Es erfolgt die Ausgabe sehr ausführlicher Informationen. Diese Einstellung sollte nur zu Analysezwecken verwendet werden. Das Protokoll wird schnell groß und unübersichtlich. |
|
/ConsistencyType |
(Optional) Angabe des Typs der Konsistenzprüfungen, welche ausgeführt werden sollen. Der Parameter kann mehrfach angegeben werden. Wird der Parameter nicht angegeben, werden alle Typen von Konsistenzprüfungen geladen. Zulässige Werte sind:
-
Database: Es werden Konsistenzprüfungen vom Typ Datenbanktest ausgeführt.
-
Table: Es werden Konsistenzprüfungen vom Typ Tabellentest ausgeführt.
-
Object: Es werden Konsistenzprüfungen vom Typ Objekttest ausgeführt.
Der Parameter kann nicht mit dem Parameter /UidConsistencyCheck kombiniert werden. |
|
/UidConsistencyCheck |
(Optional) Explizite Angabe der UID einer Konsistenzprüfung. Wird der Parameter angegeben, so wird nur genau diese Konsistenzprüfung ausgeführt. Der Parameter kann mehrfach angegeben werden.
Der Parameter kann nicht mit dem Parameter /ConsistencyType kombiniert werden.
Eine Liste der verfügbaren Konsistenzprüfungen kann mit der Option -l angezeigt werden. |
|
/Resultfile |
(Optional) Ausgabe der Ergebnisse der Konsistenzprüfungen in eine separate Ergebnisdatei. Wenn die Datei vorhanden ist, dann wird diese überschrieben. |
|
/ResultIdToSkip |
(Optional) Sollte der Lauf einer Konsistenzprüfung zu Fehlern führen, so werden den Ergebnissen jeweils eindeutige Fehlerkennungen zugewiesen. Diese Fehlerkennungen können durch diesen Parameter angegeben werden, um den Fehler in der Ausgabe und der Ergebnisdatei zu ignorieren. Der Parameter kann mehrfach angegeben werden. |
Beispiel: Auflisten aller Konsistenzprüfungen
DBConsCheckCmd.exe
/Conn="Data Source=<Database server>;Initial Catalog=<Database name>;User ID=<Database user>;Password=<Password>"
/Auth="Module=DialogUser;User=<User name>;Password=<Password>"
-l
Beispiel: Ausführen aller verfügbaren Konsistenzprüfungen und Ausgeben einer Ergebnisdatei
DBConsCheckCmd.exe
/Conn="Data Source=<Database server>;Initial Catalog=<Database name>;User ID=<Database user>;Password=<Password>"
/Auth="Module=DialogUser;User=<User name>;Password=<Password>"
/Resultfile="c:\temp\DBConsCheckCmd.log"
Beispiel: Ausführen ausgewählter Konsistenzprüfungen, Ausgeben einer Ergebnisdatei und Ignorieren eines Fehlers
Im Beispiel werden die beiden Konsistenzprüfungen DialogTable without Layout information mit der UID QBM-C78A4C856111AF4CA839024588197F4B und Template uses too long columns mit der UID QBM-F231939D9385514E9566F2900D8512E2 ausgeführt.
Ein Fehler mit der Fehlerkennung 1a9cef0b6bd93434c2997341d91f2c1ef420f150 wird ignoriert.
DBConsCheckCmd.exe
/Conn="Data Source=<Database server>;Initial Catalog=<Database name>;User ID=<Database user>;Password=<Password>"
/Auth="Module=DialogUser;User=<User name>;Password=<Password>"
/Resultfile="c:\temp\DBConsCheckCmd.log"
/UidConsistencyCheck="QBM-C78A4C856111AF4CA839024588197F4B"
/UidConsistencyCheck="QBM-F231939D9385514E9566F2900D8512E2"
/ResultIdToSkip="1a9cef0b6bd93434c2997341d91f2c1ef420f150"
Verwandte Themen
DatabaseAgentServiceCmd.exe
Das Programm DatabaseAgentServiceCmd.exe stellt den Database Agent Service bereit. Der Database Agent Service verarbeitet die internen Aufträge der Datenbank. Ausführliche Informationen finden Sie im One Identity Manager Konfigurationshandbuch.
Das Programm können Sie über die Kommandozeile ausführen.
Aufrufsyntax
DatabaseAgentServiceCmd.exe
/conn "{Connection string}"
[/alive "{Path to file}"]
[-f]
[-s]
Tabelle 61: Parameter und Optionen des Programms
|
/conn |
Verbindungsparameter zur Datenbank. Es ist ein Benutzer mit der minimalen Berechtigungsebene Administrativer Benutzer erforderlich.
Ausführliche Informationen zu den Berechtigungen finden Sie im One Identity Manager Installationshandbuch und im One Identity Manager Handbuch zur Autorisierung und Authentifizierung. |
|
/alive |
(Optional) Pfad zu einer Datei, die den Status des Database Agent Service anzeigt. Die Überprüfung des Status erfolgt zyklisch im Abstand von 15 Minuten. |
| -f |
(Optional) Der Database Agent Service ignoriert die Vorbereitungsphasen für die Migration und läuft auch mit älteren Datenbankversionen. |
| -s |
(Optional) Es werden keine Meldungen auf der Kommandozeile ausgegeben. |
|
-? | -h |
Anzeige der Hilfe zum Programm. |
