Utilitaire rskeymgmt

Syntaxe

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

Arguments

• -?
  Affiche la syntaxe des arguments de rskeymgmt.

• -e
  Extrait la clé symétrique utilisée pour chiffrer et déchiffrer des données pour l'instance du serveur de rapports afin que vous puissiez les copier dans un fichier.

  Cet argument ne prend pas de valeur. Cependant, vous devez inclure des arguments supplémentaires sur la ligne de commande pour effectuer l'extraction. Les arguments que vous devez spécifier incluent notamment -f et-p.

• -a
  Remplace une clé symétrique existante par une copie que vous pouvez fournir dans un fichier de sauvegarde protégé par mot de passe. Toutes les instances de la clé symétrique sont mises à jour.

  Cet argument ne prend pas de valeur. Cependant, vous devez inclure des arguments supplémentaires sur la ligne de commande pour sélectionner le fichier contenant la clé à appliquer. Les arguments que vous pouvez spécifier incluent -f et-p.

• -d
  Supprime toutes les instances de clé symétrique et toutes les données chiffrées dans une base de données de serveur de rapports. Cet argument ne prend pas de valeur.

• -s
  Génère une nouvelle clé symétrique et rechiffre l'ensemble du contenu chiffré à l'aide de la nouvelle clé. Toutes les instances de la clé symétrique sont régénérées.

• -j
  Configure une instance de serveur de rapports distante de manière à partager la base de données de serveur de rapports qui est utilisée par l'instance de serveur de rapports locale.

• -r installationID
  Supprime les informations de clé symétrique pour une instance de serveur de rapports spécifique, supprimant de ce fait le serveur de rapports d'un déploiement évolutif. installationID est une valeur GUID se trouvant dans le fichier RSReportserver.config.

• -f -f file
  Définit un chemin d'accès complet au fichier qui stocke une copie de sauvegarde des clés symétriques.

  Pour rskeymgmt -e, la clé symétrique est écrite dans le fichier que vous spécifiez.

  Pour rskeymgmt -a, la clé symétrique stockée dans le fichier est appliquée à l'instance du serveur de rapports.

• -p password
  (Requis pour -f) Spécifie le mot de passe utilisé pour sauvegarder ou appliquer une clé symétrique. Cette valeur ne peut pas être vide.

• -i
  Spécifie une instance de serveur de rapports locale. Cet argument est facultatif si vous avez installé le serveur de rapports sur l'instance de SQL Server par défaut (la valeur par défaut de -i est MSSQLSERVER). Si vous avez installé le serveur de rapports en tant qu'instance nommée, -i est requis.

• -m
  Spécifie le nom de l'ordinateur distant qui héberge l'instance de serveur de rapports que vous joignez au déploiement évolutif de serveurs de rapports. Utilisez le nom de l'ordinateur qui l'identifie sur votre réseau.

• -n
  Spécifie le nom de l'instance de serveur de rapports sur un ordinateur distant. Cet argument est facultatif si vous avez installé le serveur de rapports sur l'instance de SQL Server par défaut (la valeur par défaut de -n est MSSQLSERVER). Si vous avez installé le serveur de rapports en tant qu'instance nommée, -n est requis.

• -u useraccount
  Spécifie le compte d'administrateur sur l'ordinateur distant que vous joignez au déploiement évolutif. Si un compte n'est pas spécifié, les informations d'identification de l'utilisateur actuel sont employées.

• -v password
  (Requis pour -u) Spécifie le mot de passe d'un compte d'administrateur sur l'ordinateur distant que vous souhaitez joindre au déploiement évolutif.

• -t trace
  Envoie un résultat de trace au journal des traces. Cet argument ne prend pas de valeur. Pour plus d'informations, consultez Journal des traces du service Report Server.

Autorisations

Vous devez être un administrateur local pour pouvoir exécuter cet outil et vous devez l'exécuter localement sur l'ordinateur qui héberge le serveur de rapports. L'utilitaire rskeymgmt fonctionne avec l'instance locale de Windows Report Server (l'utilitaire ne peut pas se connecter à des instances distantes du service Windows Report Server, il ne peut donc pas être utilisé pour gérer les clés de chiffrement d'une instance distante de serveur de rapports).

Exemples

Les exemples suivants illustrent diverses manières d'utiliser rskeymgmt. Les exemples suivants illustrent l'extraction, la restauration et la suppression de clés de chiffrement, ainsi que la configuration d'un déploiement évolutif de serveurs de rapports.

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

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

rskeymgmt -d

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

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

rskeymgmt -r <installationID>

Emplacement du fichier

Rskeymgmt.exe se trouve dans <lecteur>:\Program Files\Microsoft SQL Server\100\Tools\Binn. Vous pouvez exécuter l'utilitaire à partir de n'importe quel répertoire de votre système de fichiers.

Notes

Un serveur de rapports chiffre les informations d'identification et les informations de connexion stockées. Une clé publique et une clé symétrique sont utilisées pour chiffrer les données. La base de données d'un serveur de rapports doit posséder les clés valides pour que le serveur de rapports puisse s'exécuter. Vous pouvez utiliser rskeymgmt pour sauvegarder, supprimer ou restaurer les clés. Si les clés ne peuvent pas être restaurées, cet outil permet de supprimer un contenu chiffré qui ne peut plus être utilisé.

L'utilitaire rskeymgmt sert à gérer l'ensemble des clés qui est défini pendant l'installation ou durant l'initialisation. Il se connecte au service Windows Report Server par l'intermédiaire d'un point de terminaison de RPC (Remote Procedure Call). Le service Windows Report Server doit être en cours d'exécution pour permettre le fonctionnement de cet utilitaire.

Pour plus d'informations sur les clés de chiffrement, consultez Configuration et gestion des clés de chiffrement et Initialisation d'un serveur de rapports.

Voir aussi

Concepts