Utilità rskeymgmt (SSRS)rskeymgmt Utility (SSRS)

Questa utilità consente di estrarre, ripristinare, creare ed eliminare la chiave simmetrica utilizzata per proteggere i dati riservati del server di report dall'accesso non autorizzato.Extracts, restores, creates, and deletes the symmetric key used to protect sensitive report server data against unauthorized access. Questa utilità viene inoltre utilizzata per unire in join istanze del server di report in un'implementazione basata sulla scalabilità orizzontale.This utility is also used to join report server instances in a scale-out deployment. La distribuzione con scalabilità orizzontale di un server di report fa riferimento a più istanze del server di report che condividono lo stesso database del server di report.A report server scale-out deployment refers to multiple report server instances that share a single report server database.

SintassiSyntax


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

ArgomentiArguments

-?-?
Visualizza la sintassi degli argomenti rskeymgmt .Displays the syntax of rskeymgmt arguments.

-e-e
Consente di estrarre la chiave simmetrica utilizzata per crittografare e decrittografare i dati per l'istanza del server di report in modo da renderne possibile la copia in un file.Extracts the symmetric key used to encrypt and decrypt data for the report server instance so that you can copy it to a file.

Questo argomento non accetta un valore.This argument does not take a value. Per completare l'estrazione, tuttavia, è necessario includere ulteriori argomenti.However, you must include additional arguments on the command line to complete the extraction. Gli argomenti che è necessario specificare includono -f e-p.The arguments that you must specify include -f and-p.

-a-a
Sostituisce una chiave simmetrica esistente con una copia specificata in un file di backup protetto da password.Replaces an existing symmetric key with a copy that you provide in a password protected backup file. Tutte le istanze della chiave simmetrica vengono aggiornate.All instances of the symmetric key are updated.

Questo argomento non accetta un valore.This argument does not take a value. Per selezionare il file contenente la chiave da applicare, è tuttavia necessario includere ulteriori argomenti.However, you must include additional arguments on the command line to select the file that contains the key to be applied. Gli argomenti che è possibile specificare includono -f e-p.The arguments that you can specify include -f and-p.

-d-d
Elimina tutte le istanze della chiave simmetrica e tutti i dati crittografati in un database del server di report.Deletes all symmetric key instances and all encrypted data in a report server database. Questo argomento non accetta un valore.This argument does not take a value.

-s-s
Genera una nuova chiave simmetrica e crittografa di nuovo tutto il contenuto crittografato in base alla nuova chiave.Generates a new symmetric key and re-encrypts all encrypted content using the new key. Tutte le istanze della chiave simmetrica verranno rigenerate.All instances of the symmetric key are regenerated.

-j-j
Configura un'istanza remota del server di report in modo che condivida il database del server di report utilizzato dall'istanza locale del server di report.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
Consente di rimuovere le informazioni relative alla chiave simmetrica per un'istanza specifica del server di report, quindi di rimuovere il server di report da un'implementazione basata sulla scalabilità orizzontale.Removes the symmetric key information for a specific report server instance, thereby removing the report server from a scale-out deployment. installationID è un valore GUID disponibile nel file RSReportserver.config.The installationID is a GUID value that can be found in the RSReportserver.config file.

-f file-f file
Consente di specificare il percorso completo del file in cui è archiviata una copia di backup delle chiavi simmetriche.Specifies a fully qualified path to the file that stores a backup copy of the symmetric keys.

Per l'argomento rskeymgmt -e, la chiave simmetrica viene scritta nel file specificato.For rskeymgmt -e, the symmetric key is written to the file you specify.

Per l'argomento rskeymgmt -a, il valore di chiave simmetrica archiviato nel file viene applicato all'istanza del server di report.For rskeymgmt -a, the symmetric key value stored in the file is applied to the report server instance.

-p password-p password
(Obbligatorio per -f) Consente di specificare la password usata per eseguire il backup o applicare una chiave simmetrica.(Required for -f) Specifies the password used to back up or apply a symmetric key. Questo valore non può essere omesso.This value cannot be empty.

-i-i
Specifica un'istanza locale del server di report.Specifies a local report server instance. Questo argomento è facoltativo se il server di report è stato installato nell'istanza predefinita di SQL ServerSQL Server (il valore predefinito per -i è 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). Se si installa il server di report come istanza denominata, l'argomento -i è obbligatorio.If you installed the report server as a named instance, -i is required.

-m-m
Specifica il nome del computer remoto in cui risiede l'istanza del server di report che si sta unendo in join all'implementazione del server di report basata sulla scalabilità orizzontale.Specifies the name of the remote computer that hosts the report server instance you are joining to the report server scale-out deployment. Utilizzare il nome del computer che lo identifica all'interno della rete.Use the name of the computer that identifies it on your network.

-n
Specifica il nome dell'istanza del server di report in un computer remoto.Specifies the name of the report server instance on a remote computer. Questo argomento è facoltativo se il server di report è stato installato nell'istanza predefinita di SQL ServerSQL Server (il valore predefinito per -n è 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). Se si installa il server di report come istanza denominata, l'argomento -n è obbligatorio.If you installed the report server as a named instance, -n is required.

-u useraccount-u useraccount
Consente di specificare l'account amministratore nel computer remoto che si sta unendo in join alla distribuzione con scalabilità orizzontaleSpecifies the administrator account on the remote computer that you are joining to the scale-out deployment. Se non si specifica un account, vengono utilizzate le credenziali dell'utente corrente.If an account is not specified, the credentials of the current user are used.

-v password-v password
(Obbligatorio per -u) Consente di specificare la password di un account amministratore nel computer remoto che si desidera unire in join alla distribuzione con scalabilità orizzontale.(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 trace-t trace
Crea l'output dei messaggi di errore nel log di traccia.Outputs error messages to the trace log. Questo argomento non accetta un valore.This argument does not take a value. Per altre informazioni, vedere Report Server Service Trace Log.For more information, see Report Server Service Trace Log.

PermissionsPermissions

Per eseguire lo strumento è necessario essere un amministratore locale ed eseguirlo a livello locale nel computer in cui risiede il server di report.You must be a local administrator to run the tool, and you must run it locally on the computer that hosts the report server. L'utilità rskeymgmt interagisce con l'istanza locale del servizio Windows ReportServer. L'utilità non è infatti in grado di connettersi alle istanze remote del servizio Windows ReportServer e pertanto non può essere utilizzata per gestire le chiavi di crittografia di un'istanza remota del server di report.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).

Nota

Se si usano gli argomenti -u e -v , verificare di aver specificato un account che dispone delle autorizzazioni di amministratore nel computer remoto.If you are using the -u and -v arguments, be sure to specify an account that has administrator permissions on the remote computer.

EsempiExamples

Gli esempi seguenti illustrano alcuni modi per usare rskeymgmt.The following examples illustrate ways of using rskeymgmt. Negli esempi seguenti viene illustrato come estrarre, ripristinare ed eliminare le chiavi di crittografia, nonché come configurare una distribuzione con scalabilità orizzontale di un server di report.The following examples show how to extract, restore, and delete encryption keys, and how to configure a report server scale-out deployment.

Estrazione delle chiavi di crittografiaExtracting Encryption Keys

Nell'esempio seguente viene illustrato come creare una copia di backup della chiave di crittografia e come salvarla in un file protetto da password in un disco floppy.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. Se il server di report è stato installato come istanza denominata, aggiungere l'argomento -i .If the report server is installed as a named instance, add the -i argument.

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

Ripristino delle chiavi di crittografiaRestoring Encryption Keys

Nell'esempio seguente viene illustrato come sostituire la chiave di crittografia.This example shows how to replace the encryption key. È necessario specificare la posizione della copia di backup della chiave e la password che sblocca il file.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>  

Eliminazione delle chiavi di crittografia e del contenuto crittografatoDeleting Encryption Keys and Encrypted Content

Nell'esempio seguente viene illustrato come eliminare tutte le chiavi di crittografia archiviate in un server di report.This example shows how to delete all encryption keys stored in a report server. Se l'installazione corrente è un'implementazione del server di report basata sulla scalabilità orizzontale, verranno eliminate le chiavi di crittografia per tutte le istanze del server di report incluse nell'implementazione.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. L'eliminazione di una chiave di crittografia comporta l'eliminazione anche dei valori crittografati esistenti nel database del server di report.Deleting an encryption key also deletes any existing encrypted values in the report server database. Per altre informazioni sul contenuto crittografato, vedere Archiviare i dati crittografati del server di report (Gestione configurazione SSRS).For more information about encrypted content, see Store Encrypted Report Server Data (SSRS Configuration Manager).

rskeymgmt -d  

Unione in join di un'istanza remota denominata del server di report a un'implementazione basata sulla scalabilità orizzontaleJoining a Remote Report Server Named Instance to a Scale-out Deployment

Nell'esempio seguente viene illustrato come aggiungere un'istanza del server di report installata in un computer remoto a un'implementazione del server di report basata sulla scalabilità orizzontale.This example shows how to add a report server instance that is installed on a remote computer to a report server scale-out deployment. È necessario eseguire il comando in uno dei computer già configurati per l'utilizzo del database condiviso.You must run the command on one of the computers that is already configured to use the shared database. Gli argomenti del comando specificano l'istanza remota del server di report che si desidera unire in join all'implementazione basata sulla scalabilità orizzontale.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>  

Nota

Un'implementazione del server di report basata sulla scalabilità orizzontale fa riferimento a un modello di implementazione dove più istanze del server di report condividono lo stesso database.A report server scale-out deployment refers to a deployment model where multiple report server instances share the same report server database. Un database del server di report può essere utilizzato da qualsiasi istanza del server di report che archivia le relative chiavi simmetriche nel database.A report server database can be used by any report server instance that stores its symmetric keys in the database. Se, ad esempio, un database del server di report contiene le informazioni sulle chiavi per tre istanze del server di report, queste tre istanze verranno considerate membri della stessa implementazione basata sulla scalabilità orizzontale.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.

Unione in join di istanze del server di report nello stesso computerJoining Report Server Instances on the Same Computer

È possibile creare una distribuzione con scalabilità orizzontale da più istanze del server di report installate nello stesso computer.You can create a scale-out deployment from multiple report server instances that are installed on the same computer. Se si esegue l'unione in join di istanze del server di report installate localmente, non impostare gli argomenti -u e -v .Do not set the -u and -v arguments if you are joining report server instances that are installed locally. Gli argomenti -u e -v vengono infatti usati solo per l'unione in join di un'istanza di un computer remoto.The -u and -v arguments are used only when you are joining an instance from a remote computer. Se si specificano tali argomenti, viene visualizzato il messaggio di errore seguente: "Impossibile usare le credenziali dell'utente per le connessioni locali".If you specify the arguments, you will get the following error: "User credentials cannot be used for local connections."

Nell'esempio seguente viene illustrata la sintassi per la creazione di una distribuzione con scalabilità orizzontale utilizzando più istanze locali.The following example illustrates the syntax for creating a scale-out deployment using multiple local instances. In questo esempio, < initializedinstance> è il nome di un'istanza che è già inizializzato per l'utilizzo di database del server di report e < newinstance> è il nome dell'istanza che si desidera aggiungere alla distribuzione: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>  

Rimozione delle chiavi di crittografia per un singolo server di report in un'implementazione basata sulla scalabilità orizzontaleRemoving Encryption Keys for a Single Report Server in a Scale-out Deployment

Nell'esempio seguente viene illustrato come rimuovere le chiavi di crittografia per un singolo server di report in un'implementazione del server di report basata sulla scalabilità orizzontale.This example shows how to remove the encryption keys for a single report server in a report server scale-out deployment. Le chiavi vengono rimosse dal database del server di report.The keys are removed from the report server database. Dopo l'eliminazione delle chiavi relative all'istanza specifica del server di report, tale istanza non potrà più accedere ai dati crittografati nel database e pertanto verrà rimossa in modo definitivo dall'implementazione basata sulla scalabilità orizzontale.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.

Per rimuovere un'istanza del server di report da una distribuzione con scalabilità orizzontale, è necessario specificare un ID di installazione.Removing a report server instance from a scale-out deployment requires you to specify an installation ID. L'ID di installazione è un GUID archiviato nel file RSReportserver.config dell'istanza del server di report per la quale si desidera rimuovere le chiavi di crittografia.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. È necessario eseguire il comando seguente nel computer che si desidera rimuovere dall'implementazione basata sulla scalabilità orizzontale.You must run the following command on the computer that you want to remove from the scale-out deployment. Se il server di report è stato installato come istanza denominata, usare l'argomento -i per specificare l'istanza.If the report server is installed as a named instance, use the -i argument to specify the instance. Per altre informazioni, vedere File di configurazione RsReportServer.config.For more information, see RsReportServer.config Configuration File.

rskeymgmt -r <installationID>  

Percorso del fileFile Location

RSKEYMGMT.exe è <* unità>: \Programmi\Microsoft SQL Server\110\Tools\Binn * * o **< unità*>: \Programmi file (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. È possibile eseguire l'utilità da qualsiasi cartella del file system.You can run the utility from any folder on your file system.

OsservazioniRemarks

Il server di report crittografa le informazioni di connessione e le credenziali archiviate.A report server encrypts stored credentials and connection information. Per la crittografia dei dati vengono utilizzate una chiave pubblica e una chiave simmetrica.A public key and a symmetric key are used to encrypt data. Il server di report viene eseguito solo se un database del server di report dispone di chiavi valide.A report server database must have valid keys in order for the report server to run. È possibile usare rskeymgmt per eseguire il backup, eliminare o ripristinare le chiavi.You can use rskeymgmt to back up, delete, or restore the keys. Se non è possibile ripristinare le chiavi, questo strumento consente di eliminare il contenuto crittografato non più utilizzabile.If the keys cannot be restored, this tool provides a way to delete encrypted content that can no longer be used.

L'utilità rskeymgmt consente di gestire il set di chiavi definito durante l'installazione o l'inizializzazione.The rskeymgmt utility is used to manage the key set that is defined during Setup or during initialization. L'utilità si connette al servizio Windows ReportServer locale tramite un endpoint RPC (Remote Procedure Call, chiamata di procedura remota).It connects to the local Report Server Windows service through a Remote Procedure Call (RPC) endpoint. Per garantire il corretto funzionamento di questa utilità, è necessario che il servizio Windows ReportServer sia in esecuzione.The Report Server Windows service must be running in order for this utility to work.

Per altre informazioni sulle chiavi di crittografia, vedere Configurare e gestire chiavi di crittografia (Gestione configurazione SSRS) e Inizializzare un server di report (Gestione configurazione SSRS).For more information about the encryption keys, see Configure and Manage Encryption Keys (SSRS Configuration Manager) and Initialize a Report Server (SSRS Configuration Manager).

Vedere ancheSee Also

Configurare una distribuzione con scalabilità orizzontale di un server di report in modalità nativa (Gestione configurazione) Scale-out Deployment - Reporting Services Native mode (Configuration Manager)
Server Reporting Services Report ( Modalità nativa ) Reporting Services Report Server (Native Mode)
Utilità di prompt dei comandi di Server di report ( SSRS ) Report Server Command Prompt Utilities (SSRS)
Configurare e gestire chiavi di crittografia ( Gestione configurazione SSRS )Configure and Manage Encryption Keys (SSRS Configuration Manager)