ServiceClient.Create Methode

Definition

Namespace:

Microsoft.Azure.Devices

Assembly:

Microsoft.Azure.Devices.dll

Paket:

Microsoft.Azure.Devices v1.38.1

Überlädt

Create(String, AzureSasCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)	Erstellt ServiceClient mithilfe einer Shared Access Signature, die vom Aufrufer bereitgestellt und aktualisiert wird.
Create(String, TokenCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)	Erstellt ServiceClient und authentifiziert sich mithilfe einer Identität in Azure Active Directory (AAD).

Create(String, AzureSasCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)

Erstellt ServiceClient mithilfe einer Shared Access Signature, die vom Aufrufer bereitgestellt und aktualisiert wird.

public static Microsoft.Azure.Devices.ServiceClient Create (string hostName, Azure.AzureSasCredential credential, Microsoft.Azure.Devices.TransportType transportType = Microsoft.Azure.Devices.TransportType.Amqp, Microsoft.Azure.Devices.ServiceClientTransportSettings transportSettings = default, Microsoft.Azure.Devices.ServiceClientOptions options = default);

static member Create : string * Azure.AzureSasCredential * Microsoft.Azure.Devices.TransportType * Microsoft.Azure.Devices.ServiceClientTransportSettings * Microsoft.Azure.Devices.ServiceClientOptions -> Microsoft.Azure.Devices.ServiceClient

Public Shared Function Create (hostName As String, credential As AzureSasCredential, Optional transportType As TransportType = Microsoft.Azure.Devices.TransportType.Amqp, Optional transportSettings As ServiceClientTransportSettings = Nothing, Optional options As ServiceClientOptions = Nothing) As ServiceClient

Parameter

hostName

String

IoT Hub-Hostname.

credential

AzureSasCredential

Anmeldeinformationen, die ein SAS-Token für die Authentifizierung bei IoT Hub generieren. Siehe AzureSasCredential.

transportType

TransportType

Gibt an, ob Amqp- oder Amqp_WebSocket_Only-Transport verwendet wird.

transportSettings

ServiceClientTransportSettings

Gibt die AMQP_WS- und HTTP-Proxyeinstellungen für den Dienstclient an.

options

ServiceClientOptions

Die Optionen, die die Konfiguration des Dienstclients instance während der Initialisierung ermöglichen.

Gibt zurück

ServiceClient

Ein ServiceClient-instance.

Hinweise

Benutzer möchten möglicherweise ihre eigenen SAS-Token (Shared Access Signature) erstellen, anstatt den freigegebenen Schlüssel an das SDK zu übergeben und das Signieren und Erneuern zu verwalten. Das AzureSasCredential -Objekt gewährt dem SDK Zugriff auf das SAS-Token, während der Aufrufer es nach Bedarf mithilfe der Update(String) -Methode aktualisieren kann.

Create(String, TokenCredential, TransportType, ServiceClientTransportSettings, ServiceClientOptions)

Erstellt ServiceClient und authentifiziert sich mithilfe einer Identität in Azure Active Directory (AAD).

public static Microsoft.Azure.Devices.ServiceClient Create (string hostName, Azure.Core.TokenCredential credential, Microsoft.Azure.Devices.TransportType transportType = Microsoft.Azure.Devices.TransportType.Amqp, Microsoft.Azure.Devices.ServiceClientTransportSettings transportSettings = default, Microsoft.Azure.Devices.ServiceClientOptions options = default);

static member Create : string * Azure.Core.TokenCredential * Microsoft.Azure.Devices.TransportType * Microsoft.Azure.Devices.ServiceClientTransportSettings * Microsoft.Azure.Devices.ServiceClientOptions -> Microsoft.Azure.Devices.ServiceClient

Public Shared Function Create (hostName As String, credential As TokenCredential, Optional transportType As TransportType = Microsoft.Azure.Devices.TransportType.Amqp, Optional transportSettings As ServiceClientTransportSettings = Nothing, Optional options As ServiceClientOptions = Nothing) As ServiceClient

Parameter

hostName

String

IoT Hub-Hostname.

credential

TokenCredential

Azure Active Directory-Anmeldeinformationen für die Authentifizierung bei IoT Hub. Siehe TokenCredential.

transportType

TransportType

Gibt an, ob Amqp- oder Amqp_WebSocket_Only-Transport verwendet wird.

transportSettings

ServiceClientTransportSettings

Gibt die AMQP_WS- und HTTP-Proxyeinstellungen für den Dienstclient an.

options

ServiceClientOptions

Die Optionen, die die Konfiguration des Dienstclients instance während der Initialisierung ermöglichen.

Gibt zurück

ServiceClient

Ein ServiceClient-instance.

Hinweise

Weitere Informationen zu den Authentifizierungsoptionen mit einem abgeleiteten instance von TokenCredentialfinden Sie unter https://docs.microsoft.com/dotnet/api/overview/azure/identity-readme. Weitere Informationen zum Konfigurieren von IoT Hub mit Azure Active Directory finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-dev-guide-azure-ad-rbac