Freigeben über


Befehl „AddResource“: Zertifikat

Um einer BizTalk-Anwendung ein Sicherheitszertifikat hinzuzufügen, verwenden Sie den Befehl AddResource und geben System.BizTalk:Certificate für den Type-Parameter an. Damit dieser Befehl funktioniert, muss das Zertifikat im Zertifikatsspeicher "Andere Personen" auf dem lokalen Computer vorhanden sein.

Dieser Befehl fügt das Zertifikat der BizTalk-Verwaltungsdatenbank hinzu. Das Zertifikat wird auch in der BizTalk Server-Verwaltungskonsole angezeigt, und zwar im Ressourcenordner der Anwendung, der Sie es hinzugefügt haben. Darüber hinaus wird das Zertifikat aufgeführt, wenn Sie den ListApp-Befehl verwenden.

Beim Installieren der Anwendung wird das Zertifikat in den Zertifikatsspeicher "Andere Personen" auf dem lokalen Computer importiert.

Verbrauch

BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Certificate [/Overwrite] /Thumbprint:"value" [/Server:value] [/Database:value]

Parameter

Parameter Erforderlich Wert
/ApplicationName (oder /A, siehe Hinweise) No Der Name der BizTalk-Anwendung, der das Zertifikat hinzugefügt werden soll. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen. Wenn der Anwendungsname nicht angegeben ist, wird die BizTalk-Standardanwendung für die Gruppe verwendet.
/Type (oder /Ty, siehe Hinweise) Yes System.BizTalk:Certificate (Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet.)
/Überschreiben (oder /O, siehe Hinweise) No Option zum Aktualisieren eines vorhandenen Zertifikats. Wenn diese Option nicht angegeben ist und in der Anwendung bereits ein Zertifikat vorhanden ist, das dieselbe Eigenschaft "Fingerabdruck" wie das hinzuzufügende Zertifikat hat, schlägt das Hinzufügen fehl. Sie können die Fingerabdruckeigenschaft anzeigen, indem Sie im Snap-In Zertifikate auf das Zertifikat doppelklicken und auf die Registerkarte Details klicken. Weitere Informationen finden Sie unter Anzeigen von Zertifikatinformationen in der Dokumentation für das Zertifikat-Snap-In.
/Fingerabdruck (oder /Th, siehe Hinweise) Yes Fingerabdruckeigenschaft des Zertifikats (ein Fingerabdruck ist ein Digest von Daten). Dieser Wert muss in doppelte Anführungszeichen (") gesetzt werden.
/Server (oder /S, siehe Hinweise) No Der Name der SQL Server-Instanz, die als Host für die BizTalk-Verwaltungsdatenbank dient, im Format Servername\Instanzname,Port.

Der Instanzname ist nur erforderlich, wenn sich der Instanzname vom Servernamen unterscheidet. Der Port ist nur erforderlich, wenn in SQL Server eine andere Portnummer als der Standardwert 1433 verwendet wird.

Beispiele:

Server=MyServer

Server=MyServer\MySQLServer,1533

Bei fehlender Angabe wird der Name der SQL Server-Instanz verwendet, die auf dem lokalen Computer ausgeführt wird.
/Database (oder /D, siehe Hinweise) No Der Name der BizTalk-Verwaltungsdatenbank. Falls nicht angegeben, wird die BizTalk Management-Datenbank verwendet, die im lokalen instance von SQL Server ausgeführt wird.

Beispiel

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

Hinweise

Bei Parametern wird die Groß- und Kleinschreibung nicht berücksichtigt. Zum Angeben von Parametern müssen Sie nicht den vollständigen Parameternamen eingeben. Es ist ausreichend, die ersten Buchstaben des Parameternamens einzugeben, die den Parameter eindeutig kennzeichnen.

Weitere Informationen

Befehl „AddResource“
Hinzufügen eines Zertifikats zu einer Anwendung