Commande AddResource : certificat
Pour ajouter un certificat de sécurité à une application BizTalk, vous utilisez la commande AddResource et spécifiez System.BizTalk :Certificate pour le paramètre Type. Pour que cette commande puisse fonctionner, le certificat doit être présent dans le magasin de certificats Autres personnes de l'ordinateur local.
Cette commande permet d'ajouter le certificat à la base de données de gestion BizTalk. Ce certificat s'affiche également dans la console Administration de BizTalk Server, dans le dossier Ressources de l'application pour laquelle vous l'avez ajouté. En outre, le certificat est répertorié lorsque vous utilisez la commande ListApp.
Lorsque vous installez l'application, le certificat est importé dans le magasin de certificats Autres personnes de l'ordinateur local.
Utilisation
BTSTask AddResource [/ApplicationName :value] /Type :System.BizTalk :Certificate [/Overwrite] /Thumbprint :"value » [/Server :value] [/Database :value]
Paramètres
| Paramètre | Obligatoire | Valeur |
|---|---|---|
| /ApplicationName (ou /A, voir Remarques) | No | Nom de l'application BizTalk pour laquelle ajouter le certificat. Si le nom comprend des espaces, vous devez le placer entre guillemets doubles (« ). Si le nom de l'application n'est pas spécifié, l'application utilisée est l'application BizTalk définie par défaut pour le groupe. |
| /Type (ou /Ty, voir Remarques) | Yes | System.BizTalk :Certificate (cette valeur ne respecte pas la casse.) |
| /Overwrite (ou /O, voir Remarques) | No | Option permettant de mettre à jour un certificat existant. Si cette option n'est pas spécifiée et qu'un certificat, dont l'empreinte est la même que celle du certificat à ajouter, existe déjà dans l'application, l'opération d'ajout échoue. Vous pouvez afficher la propriété Empreinte numérique en double-cliquant sur le certificat dans le composant logiciel enfichable Certificats et en cliquant sur l’onglet Détails. Pour plus d’informations, consultez « Affichage des informations de certificat » dans la documentation du composant logiciel enfichable Certificats. |
| /Empreinte ( ou /Th, voir Remarques) | Yes | Propriété d’empreinte numérique du certificat (une empreinte numérique est une synthèse de données). Cette valeur doit être entourée de guillemets doubles ("). |
| /Server (ou /S, voir Remarques) | No | Nom de l'instance SQL Server hébergeant la base de données de gestion BizTalk et indiqué sous la forme NomServeur\NomInstance,Port. Le nom de l'instance est uniquement requis lorsqu'il est différent du nom du serveur. Le port est uniquement requis lorsque le serveur SQL Server utilise un numéro de port autre que celui par défaut (1433). Exemples : Server=MyServer Server=MyServer\MySQLServer,1533 Si vous n'indiquez pas de nom pour l'instance SQL Server, le nom d'instance utilisé est celui de l'instance SQL Server exécutée sur l'ordinateur local. |
| /Database (ou /D, voir Remarques) | No | Nom de la base de données de gestion BizTalk. Si elle n’est pas fournie, la base de données de gestion BizTalk s’exécutant dans le instance local de SQL Server est utilisée. |
Exemple
BTSTask AddResource /ApplicationName :MyApplication /Type : System.BizTalk :Certificate /Overwrite /Thumbprint :"04 a2 8e 32 24 f9 36 b9 42 81 12 71 3a d2 ef db c7 9c 83 dc » /Server :MyDatabaseServer /Database :BizTalkMgmtDb
Remarques
Les paramètres ne respectent pas la casse. Il n'est pas nécessaire de taper le nom complet du paramètre pour l'indiquer. Vous pouvez vous contenter de taper les premières lettres du nom à condition qu'elles suffisent à identifier le paramètre sans ambiguïté.
Voir aussi
Commande AddResource
Ajout d'un certificat à une application