Connect-ServiceFabricCluster

‏‏المرجع

الوحدة النمطية:: ServiceFabric

ينشئ اتصالاً بمجموعة نسيج الخدمة.

بناء الجملة

Connect-ServiceFabricCluster
       [[-ConnectionEndpoint] <String[]>]
       [-AllowNetworkConnectionOnly]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Connect-ServiceFabricCluster
       [-ConnectionEndpoint] <String[]>
       [-AllowNetworkConnectionOnly]
       [-WindowsCredential]
       [-ClusterSpn <String>]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Connect-ServiceFabricCluster
       [-ConnectionEndpoint] <String[]>
       [-AllowNetworkConnectionOnly]
       [-X509Credential]
       [-ServerCommonName <String[]>]
       [-ServerCertThumbprint <String[]>]
       -FindType <X509FindType>
       -FindValue <String>
       [-StoreLocation <StoreLocation>]
       [-StoreName <String>]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Connect-ServiceFabricCluster
       [-ConnectionEndpoint] <String[]>
       [-AllowNetworkConnectionOnly]
       [-ServerCommonName <String[]>]
       [-ServerCertThumbprint <String[]>]
       [-DSTS]
       -MetaDataEndpoint <String>
       [-CloudServiceName <String>]
       [-CloudServiceDNSNames <String[]>]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-Interactive <Boolean>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Connect-ServiceFabricCluster
       [-ConnectionEndpoint] <String[]>
       [-AllowNetworkConnectionOnly]
       [-ServerCommonName <String[]>]
       [-ServerCertThumbprint <String[]>]
       [-AzureActiveDirectory]
       [-SecurityToken <String>]
       [-GetMetadata]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

الوصف

ينشئ الأمر cmdlet Connect-ServiceFabricCluster اتصالا بمجموعة Service Fabric مستقلة تسمح لك بتشغيل إجراءات الإدارة لتلك المجموعة. بعد الاتصال بمجموعة، يمكنك عرض إعدادات الاتصال باستخدام الأمر Cmdlet Get-ServiceFabricClusterConnection .

لإدارة مجموعات Service Fabric، ابدأ Windows PowerShell باستخدام الخيار تشغيل كمسؤول.

أمثلة

مثال 1: الاتصال بمجموعة

PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint "ServiceFabric01.ContosoCloudApp.net:19000"

ينشئ هذا الأمر اتصالا بالمجموعة المحددة.

مثال 2: الاتصال بمجموعة باستخدام شهادة X.509

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    X509Credential = $True
    StoreLocation = 'CurrentUser'
    StoreName = "MY"
    ServerCommonName = "mycluster.cloudapp.net"
    FindType = 'FindByThumbprint'
    FindValue = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"   
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs

يتصل هذا الأمر بمجموعة باستخدام شهادة X.509. يستخدم هذا الأمر ميزة splatting Windows PowerShell لإنشاء جدول تجزئة للمعلمات، ثم يوفرها إلى Connect-ServiceFabricCluster cmdlet.

مثال 3: الاتصال بمجموعة مدارة باستخدام شهادة X.509

PS C:\> $resourceGroup = 'mycluster'
PS C:\> $managedCluster = Get-AzServiceFabricManagedCluster -ResourceGroupName $resourceGroup
PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = "$($managedCluster.Fqdn):$($managedCluster.ClientConnectionPort)"
    X509Credential = $true
    StoreLocation = 'CurrentUser'
    StoreName = "MY"
    ServerCertThumbprint = (Get-AzResource -ResourceId $managedCluster.Id).Properties.clusterCertificateThumbprints
    FindType = 'FindByThumbprint'
    FindValue = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"   
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs

ملاحظه: يتطلب الاتصال بمجموعة مدارة وحدات PowerShell 'Az.ServiceFabric' و'Az.Resources' للاستعلام عن بصمات إبهام شهادة الخادم.

يستعلم هذا الأمر أولا عن مورد نظام المجموعة المدارة لبصمات إبهام شهادة الخادم الحالية، ثم يتصل بالمجموعة باستخدام شهادة X509. قم بتوفير اسم مجموعة الموارد للمجموعة المدارة لاسترداد معلومات الاتصال بما في ذلك معرف المورد الكامل للمجموعة المدارة. راجع الاتصال بمجموعة مدارة بواسطة Service Fabric.

ثم يتصل هذا الأمر بمجموعة باستخدام شهادة X.509.

مثال 4: الاتصال بمجموعة باستخدام Azure Active Directory

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    AzureActiveDirectory = $True
    ServerCertThumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs

يتصل هذا الأمر بمجموعة باستخدام مصادقة Azure Active Directory (AAD). يستخدم هذا الأمر ميزة splatting Windows PowerShell لإنشاء جدول تجزئة للمعلمات، ثم يوفرها إلى Connect-ServiceFabricCluster cmdlet.

مثال 5: الاتصال بمجموعة مؤمنة باستخدام حساب خدمة مدار بواسطة مجموعة

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    WindowsCredential = $True
    ClusterSpn = 'ServiceFabric/MyCluster.MyDomain.MyOrg'
}
PS C:\> Connect-ServiceFabricCluster @connectArgs

يستخدم هذا الأمر ميزة splatting Windows PowerShell لإنشاء جدول تجزئة للمعلمات، ثم يوفرها إلى Connect-ServiceFabricCluster cmdlet.

مثال 6: الاتصال بمجموعة مؤمنة باستخدام حسابات الجهاز

PS C:\> $connectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    WindowsCredential = $True
}
PS C:\> Connect-ServiceFabricCluster @connectArgs

يتصل هذا الأمر بمجموعة مؤمنة باستخدام حسابات الجهاز.

مثال 7: الاتصال بمجموعة دون عمليات التحقق الأساسية

PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint -SkipChecks $True "ServiceFabric01.ContosoCloudApp.net:19000"

ينشئ هذا الأمر اتصالا بالمجموعة المحددة.

المعلمات

-AllowNetworkConnectionOnly

يشير إلى أن cmdlet يسمح بالاتصال بنظام المجموعة حتى عندما تكون خدمات النظام غير مستجيبة طالما يمكن إنشاء اتصال شبكة أساسي.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuthTokenBufferSize

عند الاتصال ب AzureActiveDirectory، يحدد حجم المخزن المؤقت لتخصيصه للحصول على رمز الأمان المميز.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AzureActiveDirectory

يحدد أنه يجب استخدام Azure Active Directory للمصادقة والتخويل.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudServiceDNSNames

هذه المعلمة للاستخدام الداخلي فقط.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudServiceName

هذه المعلمة للاستخدام الداخلي فقط.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterSpn

تحديد الاسم الأساسي لأمان نظام المجموعة لاستخدامه في بيانات اعتماد Windows.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionEndpoint

تحديد صفيف من نقاط نهاية الاتصال للمجموعة بالتنسيق ClusterAddress: ClientConnectionEndpoint، حيث ClusterAddress هو عنوان IPv4 أو عنوان IPv6 أو اسم المجال المؤهل بالكامل (FQDN) لعقدة نظام المجموعة للاتصال به و ClientConnectionEndpoint هو منفذ اتصال العميل المحدد في بيان نظام المجموعة. إحاطة عناوين IPv6 بين أقواس مربعة ([]). تحتوي نقاط النهاية الصالحة على النموذج التالي:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionInitializationTimeoutInSec

تحديد فترة المهلة، بالثوان، للعملية.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DSTS

هذه المعلمة للاستخدام الداخلي فقط.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FindType

يحدد نوع FindValue للبحث عن الشهادة في مخزن الشهادات. أنواع عوامل التصفية التالية مدعومة:

FindByThumbprint. ابحث عن الشهادة حسب بصمة إبهام الشهادة.
FindBySubjectName. البحث في الشهادة في مخزن الشهادات حسب الاسم المميز للموضوع أو الاسم الشائع، عند توفير اسم الموضوع المميز في FindValue، يجب ترميز اسم الموضوع في الشهادة بترميز ASN بسبب تقييد في واجهة برمجة تطبيقات التشفير الأصلية في Windows. لا يوجد مثل هذا التقييد عند توفير الاسم الشائع في FindValue.
FindBySubjectDistinguishedName
FindByIssuerName
FindByIssuerDistinguishedName
FindBySerialNumber
FindByTimeValid
FindByTimeNotYetValid
FindByTimeExpired
FindByTemplateName
نهج FindByApplication
نهج FindByCertificate
FindByExtension
FindByKeyUsage
FindBySubjectKeyIdentifier

Type:	X509FindType
Accepted values:	FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FindValue

تحديد قيمة عامل التصفية للبحث في شهادة في مخزن الشهادات.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-GetMetadata

عند الاتصال ب AzureActiveDirectory، يسترد بيانات التعريف المستخدمة للحصول على الرمز المميز بشكل مجهول ولا يحاول أي مصادقة.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthOperationTimeoutInSec

تحديد فترة المهلة، بالثوان، لإرسال تقارير السلامة. عندما تنتهي مهلة عملية السلامة أو تفشل مع حدوث خطأ في الاتصال، يعيد العميل الصحي العملية داخليا.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthReportRetrySendIntervalInSec

يحدد الفاصل الزمني، بالثوان، الذي يقوم فيه العميل الصحي بإعادة محاولة إرسال التقارير التي فشل إرسالها أو استمرارها في المخزن الصحي. الحد الأدنى للقيمة المدعومة هو ثانية واحدة.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthReportSendIntervalInSec

يحدد الفاصل الزمني، بالثوان، الذي يرسل فيه العميل الصحي تقارير السلامة إلى مخزن الصحة. إذا تم تعيينه إلى 0، فسيرسل العميل الصحي التقارير على الفور.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Interactive

يشير إلى ما إذا كان cmdlet يعمل بشكل تفاعلي.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeepAliveIntervalInSec

تحديد فترة بقاء الاتصال على قيد الحياة بالثوان. يمنع هذا الفاصل الزمني إنهاء الاتصال بسبب عدم النشاط أثناء العمليات التي تعمل بشكل غير متزامن.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MetaDataEndpoint

هذه المعلمة للاستخدام الداخلي فقط.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionLocationCacheLimit

تحديد عدد الأقسام المخزنة مؤقتا لتحليل الخدمة. القيمة الافتراضية هي 0، مما يدل على عدم وجود حد.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecurityToken

عند الاتصال ب AzureActiveDirectory، يتم استخدام رمز الأمان المحدد مباشرة للمصادقة والتخويل بدلا من إجراء تسجيل دخول تفاعلي للمستخدم.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerCertThumbprint

تحديد صفيف من بصمات الإبهام المتوقعة لجانب نظام المجموعة. تستخدم بصمات الإبهام هذه للمصادقة على اتصال cmdlet بنقطة نهاية نظام المجموعة الصحيح أثناء مصادقة x509 أو Azure Active Directory المتبادلة.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerCommonName

تحديد صفيف من الأسماء الشائعة المتوقعة لجانب نظام المجموعة. يتم استخدام هذه الأسماء للمصادقة على أن cmdlet يتصل بنقطة نهاية نظام المجموعة الصحيح أثناء مصادقة x509 أو Azure Active Directory المتبادلة.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceChangePollIntervalInSec

يحدد الفاصل الزمني، بالثوان، الذي يستقصي فيه عميل النسيج تغييرات الخدمة. يستخدم هذا الفاصل الزمني من قبل النموذج القديم لإشعارات تغيير عنوان الخدمة المستندة إلى الاستقصاء.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipChecks

يشير إلى تجاوز عمليات التحقق من استجابة خدمة النظام عند الاتصال بالمجموعة.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StoreLocation

تحديد موقع مخزن الشهادة. القيم المقبولة لهذه المعلمة هي:

Currentuser
LocalMachine

Type:	StoreLocation
Accepted values:	CurrentUser, LocalMachine
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StoreName

يحدد اسم مخزن الشهادات لتحميل شهادة العميل.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

تحديد فترة المهلة، بالثوان، للعملية.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WindowsCredential

يشير إلى أن cmdlet يستخدم بيانات اعتماد Windows للاتصال بمجموعة Service Fabric.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-X509Credential

يشير إلى أن cmdlet يستخدم شهادة x509 لإجراء مصادقة متبادلة مع مجموعة Service Fabric.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

الإدخالات

None

المخرجات

System.Object

Share via

Connect-ServiceFabricCluster

بناء الجملة

الوصف

أمثلة

مثال 1: الاتصال بمجموعة

مثال 2: الاتصال بمجموعة باستخدام شهادة X.509

مثال 3: الاتصال بمجموعة مدارة باستخدام شهادة X.509

مثال 4: الاتصال بمجموعة باستخدام Azure Active Directory

مثال 5: الاتصال بمجموعة مؤمنة باستخدام حساب خدمة مدار بواسطة مجموعة

مثال 6: الاتصال بمجموعة مؤمنة باستخدام حسابات الجهاز

مثال 7: الاتصال بمجموعة دون عمليات التحقق الأساسية

المعلمات

-AllowNetworkConnectionOnly

-AuthTokenBufferSize

-AzureActiveDirectory

-CloudServiceDNSNames

-CloudServiceName

-ClusterSpn

-ConnectionEndpoint

-ConnectionInitializationTimeoutInSec

-DSTS

-FindType

-FindValue

-GetMetadata

-HealthOperationTimeoutInSec

-HealthReportRetrySendIntervalInSec

-HealthReportSendIntervalInSec

-Interactive

-KeepAliveIntervalInSec

-MetaDataEndpoint

-PartitionLocationCacheLimit

-SecurityToken

-ServerCertThumbprint

-ServerCommonName

-ServiceChangePollIntervalInSec

-SkipChecks

-StoreLocation

-StoreName

-TimeoutSec

-WindowsCredential

-X509Credential

الإدخالات

المخرجات

الارتباطات المرتبطة

الموارد الإضافية