rskeymgmt-Hilfsprogramm (SSRS)rskeymgmt Utility (SSRS)

Dient zum Extrahieren, Wiederherstellen, Erstellen und Löschen des symmetrischen Schlüssels, der verwendet wird, um vertrauliche Berichtsserverdaten vor nicht autorisiertem Zugriff zu schützen.Extracts, restores, creates, and deletes the symmetric key used to protect sensitive report server data against unauthorized access. Dieses Hilfsprogramm wird auch verwendet, um Berichtsserverinstanzen in einer Bereitstellung für horizontales Skalieren zu verknüpfen.This utility is also used to join report server instances in a scale-out deployment. Eine Berichtsserverbereitstellung für horizontales Skalieren bezeichnet mehrere Berichtsserverinstanzen, die gemeinsam eine einzelne Berichtsserver-Datenbank nutzen.A report server scale-out deployment refers to multiple report server instances that share a single report server database.

SyntaxSyntax

  
rskeymgmt {-?}  
{-eextract}  
{-aapply}  
{-ddeleteall}  
{-srecreatekey}  
{-rremoveinstancekey}  
{-jjoinfarm}  
{-iinstance}  
{-ffile}  
{-pencryptionpassword}  
{-mremotecomputer}  
{-ninstancenameofremotecomputer}  
{-uadministratoruseraccount}  
{-vadministratorpassword}  
{-ttrace}  

ArgumenteArguments

-?-?
Zeigt die Syntax von rskeymgmt -Argumenten an.Displays the syntax of rskeymgmt arguments.

-e-e
Extrahiert den symmetrischen Schlüssel, der zum Verschlüsseln und Entschlüsseln von Daten für die Berichtsserverinstanz verwendet wird, sodass Sie ihn in eine Datei kopieren können.Extracts the symmetric key used to encrypt and decrypt data for the report server instance so that you can copy it to a file.

Dieses Argument enthält keinen Wert.This argument does not take a value. Sie müssen jedoch zusätzliche Argumente in der Befehlszeile einschließen, um die Extrahierung abzuschließen.However, you must include additional arguments on the command line to complete the extraction. Zu den Argumenten, die Sie angeben müssen, gehören -f und -p.The arguments that you must specify include -f and -p.

-a-a
Ersetzt einen vorhandenen symmetrischen Schlüssel durch eine Kopie, die Sie in einer kennwortgeschützten Sicherungsdatei bereitstellen.Replaces an existing symmetric key with a copy that you provide in a password protected backup file. Alle Instanzen des symmetrischen Schlüssels werden aktualisiert.All instances of the symmetric key are updated.

Dieses Argument enthält keinen Wert.This argument does not take a value. Sie müssen jedoch zusätzliche Argumente in der Befehlszeile angeben, um die Datei mit dem anzuwendenden Schlüssel auszuwählen.However, you must include additional arguments on the command line to select the file that contains the key to be applied. Zu den Argumenten, die Sie angeben können, gehören -f und -p.The arguments that you can specify include -f and -p.

-d-d
Löscht alle Instanzen des symmetrischen Schlüssels und alle verschlüsselten Daten in einer Berichtsserver-Datenbank.Deletes all symmetric key instances and all encrypted data in a report server database. Dieses Argument enthält keinen Wert.This argument does not take a value.

-s-s
Generiert einen neuen symmetrischen Schlüssel und verschlüsselt alle verschlüsselten Inhalte mithilfe dieses neuen Schlüssels neu.Generates a new symmetric key and re-encrypts all encrypted content using the new key. Alle Instanzen des symmetrischen Schlüssels werden neu generiert.All instances of the symmetric key are regenerated.

-j-j
Konfiguriert eine Remoteberichtsserver-Instanz für die gemeinsame Nutzung der Berichtsserver-Datenbank, die von der lokalen Berichtsserverinstanz verwendet wird.Configures a remote report server instance to share the report server database that is used by the local report server instance.

-r installationID-r installationID
Entfernt die Informationen zu einem symmetrischen Schlüssel für eine bestimmte Berichtsserverinstanz, wodurch der Berichtsserver aus einer Bereitstellung für horizontales Skalieren entfernt wird.Removes the symmetric key information for a specific report server instance, thereby removing the report server from a scale-out deployment. installationID ist ein GUID-Wert, der in der Datei RSReportserver.config gefunden werden kann.The installationID is a GUID value that can be found in the RSReportserver.config file.

-f Datei-f file
Gibt einen vollqualifizierten Pfad zu der Datei an, in der eine Sicherungskopie der symmetrischen Schlüssel gespeichert ist.Specifies a fully qualified path to the file that stores a backup copy of the symmetric keys.

Für rskeymgmt -ewird der symmetrische Schüssel in die von Ihnen angegebene Datei geschrieben.For rskeymgmt -e, the symmetric key is written to the file you specify.

Für rskeymgmt -awird der in der Datei gespeicherte Wert des symmetrischen Schlüssels auf die Berichtsserverinstanz angewendet.For rskeymgmt -a, the symmetric key value stored in the file is applied to the report server instance.

-p Kennwort-p password
(Erforderlich für -f) Gibt das Kennwort an, das zum Sichern oder Anwenden eines symmetrischen Schlüssels verwendet wird.(Required for -f) Specifies the password used to back up or apply a symmetric key. Dieser Wert muss angegeben sein.This value cannot be empty.

-i-i
Gibt eine lokale Berichtsserverinstanz an.Specifies a local report server instance. Dieses Argument ist optional, wenn Sie den Berichtsserver auf der standardmäßigen SQL ServerSQL Server -Instanz installiert haben (der Standardwert für -i ist MSSQLSERVER).This argument is optional if you installed the report server on the default SQL ServerSQL Server instance (the default value for -i is MSSQLSERVER). Wenn Sie den Berichtsserver als benannte Instanz installiert haben, ist -i erforderlich.If you installed the report server as a named instance, -i is required.

-m-m
Gibt den Namen des Remotecomputers an, der die Berichtsserverinstanz hostet, die Sie der Berichtsserverbereitstellung für horizontales Skalieren hinzufügen.Specifies the name of the remote computer that hosts the report server instance you are joining to the report server scale-out deployment. Verwenden Sie den Namen, durch den der Computer im Netzwerk identifiziert wird.Use the name of the computer that identifies it on your network.

-n-n
Gibt den Namen der Berichtsserverinstanz auf einem Remotecomputer an.Specifies the name of the report server instance on a remote computer. Dieses Argument ist optional, wenn Sie den Berichtsserver auf der standardmäßigen SQL ServerSQL Server -Instanz installiert haben (der Standardwert für -n ist MSSQLSERVER).This argument is optional if you installed the report server on the default SQL ServerSQL Server instance (the default value for -n is MSSQLSERVER). Wenn Sie den Berichtsserver als benannte Instanz installiert haben, ist -n erforderlich.If you installed the report server as a named instance, -n is required.

-u useraccount-u useraccount
Gibt das Administratorkonto auf dem Remotecomputer an, den Sie der Bereitstellung für horizontales Skalieren hinzufügen.Specifies the administrator account on the remote computer that you are joining to the scale-out deployment. Wird kein Konto angegeben, werden die Anmeldeinformationen des aktuellen Benutzers verwendet.If an account is not specified, the credentials of the current user are used.

-v Kennwort-v password
(Erforderlich für -u) Gibt das Kennwort eines Administratorkontos auf dem Remotecomputer an, den Sie der Bereitstellung für horizontales Skalieren hinzufügen möchten.(Required for -u) Specifies the password of an administrator account on the remote computer that you want to join to the scale-out deployment.

-t Ablaufverfolgung-t trace
Schreibt Fehlermeldungen in das Ablaufverfolgungsprotokoll.Outputs error messages to the trace log. Dieses Argument enthält keinen Wert.This argument does not take a value. Weitere Informationen finden Sie unter Report Server Service Trace Log.For more information, see Report Server Service Trace Log.

BerechtigungenPermissions

Zum Ausführen dieses Tools müssen Sie als lokaler Administrator angemeldet sein, und das Tool muss lokal auf dem Computer ausgeführt werden, der den Berichtsserver hostet.You must be a local administrator to run the tool, and you must run it locally on the computer that hosts the report server. Das Hilfsprogramm rskeymgmt arbeit mit der Windows-Instanz des lokalen Berichtsservers zusammen. (Das Hilfsprogramm kann keine Verbindung mit Remoteinstanzen des Report Server-Windows-Dienstes herstellen. Es kann daher nicht zum Verwalten der Verschlüsselungsschlüssel einer Remoteberichtsserver-Instanz verwendet werden.)The rskeymgmt utility works with the local Report Server Windows instance (the utility cannot connect to remote instances of the Report Server Windows service so it cannot be used to manage the encryption keys of a remote report server instance).

Hinweis

Wenn Sie die Argumente -u und -v verwenden, müssen Sie sicherstellen, dass Sie ein Konto mit Administratorberechtigungen für den Remotecomputer verwenden.If you are using the -u and -v arguments, be sure to specify an account that has administrator permissions on the remote computer.

BeispieleExamples

Die folgenden Beispiele veranschaulichen mögliche Verwendungsweisen von rskeymgmt.The following examples illustrate ways of using rskeymgmt. In den folgenden Beispielen wird gezeigt, wie Verschlüsselungsschlüssel extrahiert, wiederhergestellt und gelöscht werden und wie eine Berichtsserverbereitstellung für horizontales Skalieren konfiguriert wird.The following examples show how to extract, restore, and delete encryption keys, and how to configure a report server scale-out deployment.

Extrahieren von VerschlüsselungsschlüsselnExtracting Encryption Keys

In diesem Beispiel wird gezeigt, wie eine Sicherungskopie des Verschlüsselungsschlüssels erstellt und in einer kennwortgeschützten Datei auf einer Diskette gespeichert wird.This example shows how to create a backup copy of the encryption key and save it to a password-protected file on a floppy disk. Wenn der Berichtsserver als benannte Instanz installiert ist, fügen Sie das Argument -i hinzu.If the report server is installed as a named instance, add the -i argument.

rskeymgmt -e -f a:\backupkey\keys -p <password>  

Wiederherstellen von VerschlüsselungsschlüsselnRestoring Encryption Keys

In diesem Beispiel wird gezeigt, wie der Verschlüsselungsschlüssel ersetzt wird.This example shows how to replace the encryption key. Sie müssen den Speicherort der Sicherungskopie des Schlüssels und das Kennwort angeben, mit dem die Dateisperre aufgehoben wird.You must specify the location of the backup copy of the key and the password that unlocks the file.

rskeymgmt -a -f a:\backupkey\keys -p <password>  

Löschen von Verschlüsselungsschlüsseln und verschlüsselten InhaltenDeleting Encryption Keys and Encrypted Content

In diesem Beispiel wird gezeigt, wie alle auf einem Berichtsserver gespeicherten Verschlüsselungsschlüssel gelöscht werden.This example shows how to delete all encryption keys stored in a report server. Wenn es sich bei der Installation um eine Berichtsserverbereitstellung für horizontales Skalieren handelt, werden die Verschlüsselungsschlüssel für alle Berichtsserverinstanzen gelöscht, die in die Bereitstellung eingeschlossen sind.If your installation is a report server scale-out deployment, the encryption keys for all report server instances that are included in the deployment will be deleted. Durch das Löschen eines Verschlüsselungsschlüssels werden auch alle verschlüsselten Werte in der Berichtsserver-Datenbank gelöscht.Deleting an encryption key also deletes any existing encrypted values in the report server database. Weitere Informationen zu verschlüsselten Inhalten finden Sie unter Speichern verschlüsselter Berichtsserverdaten (SSRS-Konfigurations-Manager).For more information about encrypted content, see Store Encrypted Report Server Data (SSRS Configuration Manager).

rskeymgmt -d  

Hinzufügen einer benannten Remoteberichtsserver-Instanz zu einer Bereitstellung für horizontales SkalierenJoining a Remote Report Server Named Instance to a Scale-out Deployment

In diesem Beispiel wird gezeigt, wie eine auf einem Remotecomputer installierte Berichtsserverinstanz zu einer Berichtsserverbereitstellung für horizontales Skalieren hinzugefügt wird.This example shows how to add a report server instance that is installed on a remote computer to a report server scale-out deployment. Sie müssen den Befehl auf einem der Computer ausführen, die bereits mithilfe der freigegebenen Datenbank konfiguriert sind.You must run the command on one of the computers that is already configured to use the shared database. Mit den Befehlsargumenten wird die Remoteberichtsserver-Instanz angegeben, die Sie der Bereitstellung für horizontales Skalieren hinzufügen möchten.The command arguments specify the remote report server instance you want to join to the scale-out deployment.

rskeymgmt -j -m <remotecomputer> -n <namedreportserverinstance> -u <administratoraccount> -v <administratorpassword>  

Hinweis

Eine Berichtsserverbereitstellung für horizontales Skalieren bezeichnet ein Bereitstellungsmodell, bei dem mehrere Berichtsserverinstanzen dieselbe Berichtsserver-Datenbank gemeinsam nutzen.A report server scale-out deployment refers to a deployment model where multiple report server instances share the same report server database. Eine Berichtsserver-Datenbank kann von jeder Berichtsserverinstanz verwendet werden, die ihre symmetrischen Schlüssel in der Datenbank speichert.A report server database can be used by any report server instance that stores its symmetric keys in the database. Wenn eine Berichtsserver-Datenbank beispielsweise Schlüsselinformationen für drei Berichtsserverinstanzen enthält, werden alle drei Instanzen als Mitglieder derselben Bereitstellung für horizontales Skalieren betrachtet.For example, if a report server database contains key information for three report server instances, all three instances are considered to members of the same scale-out deployment.

Verknüpfen von Berichtsserverinstanzen auf demselben ComputerJoining Report Server Instances on the Same Computer

Sie können eine Bereitstellung für horizontales Skalieren von mehreren Berichtsserverinstanzen aus erstellen, die auf demselben Computer installiert sind.You can create a scale-out deployment from multiple report server instances that are installed on the same computer. Legen Sie die Argumente -u und -v nicht fest, wenn Sie Berichtsserverinstanzen verknüpfen, die lokal installiert sind.Do not set the -u and -v arguments if you are joining report server instances that are installed locally. Die Argumente -u und -v werden nur verwendet, wenn Sie eine Instanz von einem Remotecomputer aus hinzufügen.The -u and -v arguments are used only when you are joining an instance from a remote computer. Wenn Sie die Argumente festlegen, wird die folgende Fehlermeldung angezeigt: "Benutzeranmeldeinformationen können nicht für lokale Verbindungen verwendet werden."If you specify the arguments, you will get the following error: "User credentials cannot be used for local connections."

Das folgende Beispiel veranschaulicht die Syntax für eine Bereitstellung für horizontales Skalieren mithilfe mehrerer lokaler Instanzen.The following example illustrates the syntax for creating a scale-out deployment using multiple local instances. In diesem Beispiel ist <initializedinstance> der Name einer Instanz, die bereits für die Verwendung der Berichtsserver-Datenbank initialisiert wurde, und <newinstance> ist der Name der Instanz, die der Bereitstellung hinzugefügt werden soll:In this example, <initializedinstance> is the name of an instance that is already initialized to use the report server database, and <newinstance> is the name of the instance that you want to add to the deployment:

rskeymgmt -j -i <initializedinstance> -m <computer name> -n <newinstance>  

Entfernen von Verschlüsselungsschlüsseln für einzelne Berichtsserver in einer Bereitstellung für horizontales SkalierenRemoving Encryption Keys for a Single Report Server in a Scale-out Deployment

In diesem Beispiel wird gezeigt, wie die Verschlüsselungsschlüssel für einen einzelnen Berichtsserver in einer Berichtsserverbereitstellung für horizontales Skalieren entfernt werden können.This example shows how to remove the encryption keys for a single report server in a report server scale-out deployment. Die Schlüssel werden aus der Berichtsserver-Datenbank entfernt.The keys are removed from the report server database. Sobald die Schlüssel für diese Berichtsserverinstanz entfernt wurden, kann die Berichtsserverinstanz nicht mehr auf die verschlüsselten Daten in der Datenbank zugreifen; die Instanz wurde somit faktisch aus der Bereitstellung für horizontales Skalieren entfernt.Once the keys for that report server instance are removed, that report server instance can no longer access encrypted data in the database, effectively removing it from the scale-out deployment.

Um eine Berichtsserverinstanz aus einer Bereitstellung für horizontales Skalieren zu entfernen, ist es erforderlich, eine Installations-ID anzugeben.Removing a report server instance from a scale-out deployment requires you to specify an installation ID. Die Installations-ID ist ein GUID, der in der Datei RSReportserver.config der Berichtsserverinstanz gespeichert ist, für die Sie die Verschlüsselungsschlüssel entfernen möchten.The installation ID is a GUID stored in the RSReportserver.config file of the report server instance for which you want to remove encryption keys. Sie müssen den folgenden Befehl auf dem Computer ausführen, den Sie aus der Bereitstellung für horizontales Skalieren entfernen möchten.You must run the following command on the computer that you want to remove from the scale-out deployment. Wenn der Berichtsserver als benannte Instanz installiert ist, verwenden Sie das Argument -i , um die Instanz anzugeben.If the report server is installed as a named instance, use the -i argument to specify the instance. Weitere Informationen finden Sie unter RSReportServer.config-Konfigurationsdatei.For more information, see RsReportServer.config Configuration File.

rskeymgmt -r <installationID>  

DateispeicherortFile Location

Rskeymgmt.exe befindet sich unter <Laufwerk>:\Programme\Microsoft SQL Server\110\Tools\Binn oder unter <Laufwerk>:\Programme (x86)\Microsoft SQL Server\110\Tools\Binn.Rskeymgmt.exe is located at <drive>:\Program Files\Microsoft SQL Server\110\Tools\Binn or at <drive>:\Program Files (x86)\Microsoft SQL Server\110\Tools\Binn. Sie können das Hilfsprogramm von einem beliebigen Ordner im Dateisystem ausführen.You can run the utility from any folder on your file system.

RemarksRemarks

Ein Berichtsserver verschlüsselt gespeicherte Anmeldeinformationen und Verbindungsinformationen.A report server encrypts stored credentials and connection information. Zum Verschlüsseln von Daten werden ein öffentlicher Schlüssel und ein symmetrischer Schlüssel verwendet.A public key and a symmetric key are used to encrypt data. Eine Berichtsserver-Datenbank muss über gültige Schlüssel verfügen, damit der Berichtsserver ausgeführt werden kann.A report server database must have valid keys in order for the report server to run. Mithilfe von rskeymgmt können Sie die Schlüssel sichern, löschen oder wiederherstellen.You can use rskeymgmt to back up, delete, or restore the keys. Wenn die Schlüssel nicht wiederhergestellt werden können, bietet dieses Tool eine Möglichkeit zum Löschen verschlüsselter Inhalte, die nicht mehr verwendet werden können.If the keys cannot be restored, this tool provides a way to delete encrypted content that can no longer be used.

Das Hilfsprogramm rskeymgmt wird zum Verwalten des Schlüsselsatzes verwendet, der während der Installation oder Initialisierung definiert wurde.The rskeymgmt utility is used to manage the key set that is defined during Setup or during initialization. Über einen RPC-Endpunkt (Remote Procedure Call, Remoteprozeduraufruf) stellt es eine Verbindung mit dem Windows-Dienst des lokalen Berichtsservers her.It connects to the local Report Server Windows service through a Remote Procedure Call (RPC) endpoint. Der Windows-Dienst des Berichtsservers muss ausgeführt werden, damit dieses Hilfsprogramm funktionsfähig ist.The Report Server Windows service must be running in order for this utility to work.

Weitere Informationen zu den Verschlüsselungsschlüsseln finden Sie unter Konfigurieren und Verwalten von Verschlüsselungsschlüsseln (SSRS-Konfigurations-Manager) und Initialisieren eines Berichtsservers (SSRS-Konfigurations-Manager).For more information about the encryption keys, see Configure and Manage Encryption Keys (SSRS Configuration Manager) and Initialize a Report Server (SSRS Configuration Manager).

Weitere InformationenSee Also

Bereitstellung für horizontales Skalieren – Reporting Services im einheitlichen Modus (Konfigurations-Manager) Scale-out Deployment - Reporting Services Native mode (Configuration Manager)
Reporting Services-Berichtsserver (einheitlicher Modus) Reporting Services Report Server (Native Mode)
Eingabeaufforderungs-Hilfsprogramme für Berichtsserver (SSRS) Report Server Command Prompt Utilities (SSRS)
Konfigurieren und Verwalten von Verschlüsselungsschlüsseln (SSRS-Konfigurations-Manager)Configure and Manage Encryption Keys (SSRS Configuration Manager)