다음을 통해 공유


Connect-ServiceFabricCluster

Service Fabric 클러스터에 대한 끝점을 만듭니다.

구문

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>]

Description

Connect-ServiceFabricCluster cmdlet은 해당 클러스터에 대한 관리 작업을 실행할 수 있는 독립 실행형 Service Fabric 클러스터에 대한 연결을 만듭니다. 클러스터에 연결한 후 Get-ServiceFabricClusterConnection cmdlet을 사용하여 연결 설정을 볼 수 있습니다.

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 인증서를 사용하여 클러스터에 연결합니다. 이 명령은 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 인증서를 사용하여 클러스터에 연결합니다. 관리형 클러스터의 전체 리소스 ID를 포함하여 연결 정보를 검색하려면 관리형 클러스터에 대한 리소스 그룹의 이름을 제공합니다. 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

이 명령은 AAD(Azure Active Directory) 인증을 사용하여 클러스터에 연결합니다. 이 명령은 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

이 명령은 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
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AuthTokenBufferSize

AzureActiveDirectory와 연결할 때 보안 토큰 획득을 위해 할당할 버퍼 크기를 지정합니다.

형식:Int64
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AzureActiveDirectory

Azure Active Directory를 인증 및 권한 부여에 사용되도록 지정합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CloudServiceDNSNames

이 매개 변수는 내부에서만 사용됩니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CloudServiceName

이 매개 변수는 내부에서만 사용됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClusterSpn

Windows 자격 증명에 사용할 클러스터 보안 주체 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ConnectionEndpoint

ClusterAddress: ClientConnectionEndpoint 형식으로 클러스터에 대한 연결 엔드포인트 배열을 지정합니다. 여기서 ClusterAddress는 연결할 클러스터 노드의 IPv4 주소, IPv6 주소 또는 FQDN(정규화된 도메인 이름)이며 ClientConnectionEndpoint는 클러스터 매니페스트에 지정된 클라이언트 연결 포트입니다. IPv6 주소를 대괄호([])로 묶습니다. 유효한 엔드포인트의 형식은 다음과 같습니다.

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

형식:String[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ConnectionInitializationTimeoutInSec

작업의 제한 시간(초)을 지정합니다.

형식:Double
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DSTS

이 매개 변수는 내부에서만 사용됩니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FindType

인증서 저장소에서 인증서를 검색하기 위한 FindValue 유형을 지정합니다. 지원되는 필터 유형은 다음과 같습니다.

  • FindByThumbprint. 인증서 지문으로 인증서를 찾습니다.
  • FindBySubjectName. 주체 고유 이름 또는 일반 이름으로 인증서 저장소의 인증서를 검색합니다. FindValue에서 주체 고유 이름이 제공되면 네이티브 Windows 암호화 API의 제한으로 인해 인증서의 주체 이름을 ASN 인코딩으로 인코딩해야 합니다. FindValue에서 일반 이름을 제공하는 경우 이러한 제한은 없습니다.
  • FindBySubjectDistinguishedName
  • FindByIssuerName
  • FindByIssuerDistinguishedName
  • FindBySerialNumber
  • FindByTimeValid
  • FindByTimeNotYetValid
  • FindByTimeExpired
  • FindByTemplateName
  • FindByApplicationPolicy
  • FindByCertificatePolicy
  • FindByExtension
  • FindByKeyUsage
  • FindBySubjectKeyIdentifier
형식:X509FindType
허용되는 값:FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FindValue

인증서 저장소에서 인증서를 검색할 필터 값을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-GetMetadata

AzureActiveDirectory와 연결할 때 토큰 획득에 사용되는 메타데이터를 익명으로 검색하고 인증을 시도하지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-HealthOperationTimeoutInSec

상태 보고서를 보내기 위한 제한 시간(초)을 지정합니다. 통신 오류로 상태 작업이 시간 초과되거나 실패하면 상태 클라이언트는 내부적으로 작업을 다시 시도합니다.

형식:Double
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-HealthReportRetrySendIntervalInSec

상태 클라이언트가 전송하지 못했거나 상태 저장소에 유지되지 않은 보고서를 다시 전송하는 간격(초)을 지정합니다. 지원되는 최소값은 1초입니다.

형식:Double
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-HealthReportSendIntervalInSec

상태 클라이언트가 상태 보고서를 상태 저장소로 보내는 간격(초)을 지정합니다. 0으로 설정하면 상태 클라이언트가 보고서를 즉시 보냅니다.

형식:Double
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Interactive

cmdlet이 대화형으로 작동하는지 여부를 나타냅니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-KeepAliveIntervalInSec

연결 연결 유지 기간(초)을 지정합니다. 이 간격은 비동기적으로 실행되는 작업 중 비활성으로 인해 연결이 종료되지 않도록 합니다.

형식:Double
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MetaDataEndpoint

이 매개 변수는 내부에서만 사용됩니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PartitionLocationCacheLimit

서비스 확인을 위해 캐시된 파티션 수를 지정합니다. 기본값은 0으로, 제한이 없음을 의미합니다.

형식:Int64
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SecurityToken

AzureActiveDirectory와 연결할 때 지정된 보안 토큰은 대화형 사용자 로그인을 수행하는 대신 인증 및 권한 부여에 직접 사용됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServerCertThumbprint

클러스터 쪽에 대해 예상되는 지문의 배열을 지정합니다. 이러한 지문은 x509 또는 Azure Active Directory 상호 인증 중에 cmdlet이 올바른 클러스터의 엔드포인트에 연결되는지 인증하는 데 사용됩니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServerCommonName

클러스터 쪽에 대해 예상되는 일반 이름의 배열을 지정합니다. 이러한 이름은 x509 또는 Azure Active Directory 상호 인증 중에 cmdlet이 올바른 클러스터의 엔드포인트에 연결되는지 인증하는 데 사용됩니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServiceChangePollIntervalInSec

패브릭 클라이언트가 서비스 변경 내용을 폴링하는 간격(초)을 지정합니다. 이 간격은 폴링 기반 서비스 주소 변경 알림의 이전 모델에서 사용됩니다.

형식:Double
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkipChecks

클러스터에 연결할 때 시스템 서비스 응답성 유효성 검사를 무시함을 나타냅니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-StoreLocation

인증서의 저장소 위치를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • CurrentUser
  • LocalMachine
형식:StoreLocation
허용되는 값:CurrentUser, LocalMachine
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-StoreName

클라이언트 인증서를 로드할 인증서 저장소의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TimeoutSec

작업의 제한 시간(초)을 지정합니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WindowsCredential

cmdlet이 Windows 자격 증명을 사용하여 Service Fabric 클러스터에 연결했음을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-X509Credential

cmdlet이 x509 인증서를 사용하여 Service Fabric 클러스터와의 상호 인증을 수행했음을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

출력

System.Object