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 يسمح بالاتصال بنظام المجموعة حتى عندما تكون خدمات النظام غير مستجيبة طالما يمكن إنشاء اتصال شبكة أساسي.

النوع:	SwitchParameter
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-AuthTokenBufferSize

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

النوع:	Int64
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-AzureActiveDirectory

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

النوع:	SwitchParameter
Position:	Named
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-CloudServiceDNSNames

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

النوع:	String[]
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-CloudServiceName

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

النوع:	String
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-ClusterSpn

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

النوع:	String
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-ConnectionEndpoint

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

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

النوع:	String[]
Position:	0
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-ConnectionInitializationTimeoutInSec

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

النوع:	Double
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-DSTS

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

النوع:	SwitchParameter
Position:	Named
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-FindType

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

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

النوع:	X509FindType
القيم المقبولة:	FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:	Named
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-FindValue

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

النوع:	String
Position:	Named
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-GetMetadata

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

النوع:	SwitchParameter
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-HealthOperationTimeoutInSec

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

النوع:	Double
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-HealthReportRetrySendIntervalInSec

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

النوع:	Double
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-HealthReportSendIntervalInSec

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

النوع:	Double
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-Interactive

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

النوع:	Boolean
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-KeepAliveIntervalInSec

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

النوع:	Double
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-MetaDataEndpoint

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

النوع:	String
Position:	Named
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-PartitionLocationCacheLimit

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

النوع:	Int64
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-SecurityToken

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

النوع:	String
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-ServerCertThumbprint

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

النوع:	String[]
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-ServerCommonName

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

النوع:	String[]
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-ServiceChangePollIntervalInSec

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

النوع:	Double
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-SkipChecks

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

النوع:	Boolean
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-StoreLocation

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

Currentuser
LocalMachine

النوع:	StoreLocation
القيم المقبولة:	CurrentUser, LocalMachine
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-StoreName

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

النوع:	String
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-TimeoutSec

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

النوع:	Int32
Position:	Named
القيمة الافتراضية:	None
مطلوب:	False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-WindowsCredential

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

النوع:	SwitchParameter
Position:	Named
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

-X509Credential

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

النوع:	SwitchParameter
Position:	Named
القيمة الافتراضية:	None
مطلوب:	True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:	False
قبول أحرف البدل:	False

الإدخالات

None

المخرجات

System.Object

مشاركة عبر

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

الإدخالات

المخرجات

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

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