PublishToAzureServiceBus@1 – Aufgabe "In Azure Service Bus v1 veröffentlichen"

Artikel
2025-03-24

Verwenden Sie diese Aufgabe, um eine Nachricht mithilfe einer Dienstverbindung an Azure Service Bus zu senden (kein Agent ist erforderlich).

Syntax

# Publish To Azure Service Bus v1
# Sends a message to Azure Service Bus using a service connection (no agent is required).
- task: PublishToAzureServiceBus@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceName. Required. Azure Service Bus service connection. 
    #messageBody: # string. Message body. 
    #waitForCompletion: false # boolean. Wait for task completion. Default: false.
    #useDataContractSerializer: true # boolean. Use .NET data contract serializer. Default: true.
  # Advanced
    #sessionId: # string. Session Id. 
    #signPayload: false # boolean. Sign the Message. Default: false.
    #certificateString: # string. Required when signPayload = true. Certificate Variable. 
    #signatureKey: 'signature' # string. Optional. Use when signPayload = true. Signature Property Key. Default: signature.

# Publish To Azure Service Bus v1
# Sends a message to Azure Service Bus using a service connection (no agent is required).
- task: PublishToAzureServiceBus@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceName. Required. Azure Service Bus service connection. 
    #messageBody: # string. Message body. 
    #waitForCompletion: false # boolean. Wait for task completion. Default: false.
  # Advanced
    #sessionId: # string. Session Id. 
    #signPayload: false # boolean. Sign the Message. Default: false.
    #certificateString: # string. Required when signPayload = true. Certificate Variable. 
    #signatureKey: 'signature' # string. Optional. Use when signPayload = true. Signature Property Key. Default: signature.

Eingänge

azureSubscription - Azure Service Bus-Dienstverbindung
Eingabealias: connectedServiceName. string. Erforderlich.

Gibt eine Azure Service Bus-Dienstverbindungan.

messageBody - Nachrichtentext
string.

Gibt den JSON-messageBodyan.

sessionId - Sitzungs-ID
string.

Gibt die Sitzungs-ID an, mit der die Nachricht veröffentlicht wird. Bei sitzungsbasierten Warteschlangen schlägt die Veröffentlichung fehl, wenn kein Wert angegeben wird. Bei nicht sitzungsbasierten Warteschlangen muss kein Wert angegeben werden.

signPayload - Signieren der Nachricht
boolean. Standardwert: false.

Bei Festlegung auf truewird der Nachricht ein privates Zertifikat hinzugefügt.

certificateString - Zertifikatvariablen
string. Erforderlich, wenn signPayload = true.

Gibt die geheime Variable an, die den Zertifikatinhalt enthält. Dies kann auch ein Zertifikat sein, das in einem Azure Key Vault gespeichert ist, das verknüpften mit einer Variablengruppe verknüpft ist, die von der Releasepipeline verwendet wird.

signatureKey - Signatureigenschaftsschlüssel
string. Wahlfrei. Wird verwendet, wenn signPayload = true. Standardwert: signature.

Gibt in den Nachrichteneigenschaften den Schlüssel an, in dem sich die Signatur befindet. Wenn er leer bleibt, wird der Standardwert signature.

waitForCompletion - Aufgabenabschluss warten
boolean. Standardwert: false.

Wenn dieser Vorgang auf truefestgelegt ist, wartet dieser Vorgang auf das TaskCompleted-Ereignis für das angegebene Aufgabentimeout.

useDataContractSerializer - Verwenden des Serialisierungsprogramms für .NET-Daten.
boolean. Standardwert: true.

Legen Sie useDataContractSerializer auf false fest, wenn Sie Ihre Nachricht als Datenstrom anstelle eines Objekts übergeben möchten.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Verwenden Sie diese Aufgabe in einem agentlosen Auftrag einer Releasepipeline, um eine Nachricht mithilfe einer Dienstverbindung (ohne Einen Agent) an einen Azure Service Bus zu senden.

Hinweis

Kann nur in einem agentlosen Job einer Releasepipeline verwendet werden.

Wo sollte ein Vorgangssignal abgeschlossen werden?

Um den Abschluss zu signalisieren, sollte der externe Dienst POST-Abschlussdaten an den folgenden Pipelines-REST-Endpunkt senden.

{planUri}/{projectId}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/events?api-version=2.0-preview.1

**Request Body**
 { "name": "TaskCompleted", "taskId": "taskInstanceId", "jobId": "jobId", "result": "succeeded" }

Weitere Informationen finden Sie in dieser einfachen cmdline-Anwendung.

Darüber hinaus ist eine C#-Hilfsbibliothek verfügbar, um die Liveprotokollierung und verwaltung des Aufgabenstatus für agentlose Aufgaben zu ermöglichen. Erfahren Sie mehr über Async HTTP Agentless Tasks.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Server
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	Alle unterstützten Agentversionen.
Vorgangskategorie	Nützlichkeit

Freigeben über