다음을 통해 공유

Connect-ServiceFabricCluster

모듈:
ServiceFabric Module

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

구문

Default 

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

Windows 

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

X509 

Connect-ServiceFabricCluster
    [-ConnectionEndpoint] <String[]>
    -FindType <X509FindType>
    -FindValue <String>
    [-AllowNetworkConnectionOnly]
    [-X509Credential]
    [-ServerCommonName <String[]>]
    [-ServerCertThumbprint <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>]

Dsts 

Connect-ServiceFabricCluster
    [-ConnectionEndpoint] <String[]>
    -MetaDataEndpoint <String>
    [-AllowNetworkConnectionOnly]
    [-ServerCommonName <String[]>]
    [-ServerCertThumbprint <String[]>]
    [-DSTS]
    [-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>]

Aad 

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
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AuthTokenBufferSize

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

매개 변수 속성

형식:Int64
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AzureActiveDirectory

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Aad
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-CloudServiceDNSNames

이 매개변수는 내부용으로만 사용됩니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Dsts
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-CloudServiceName

이 매개변수는 내부용으로만 사용됩니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Dsts
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ClusterSpn

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Windows
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ConnectionEndpoint

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

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Default
Position:0
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ConnectionInitializationTimeoutInSec

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

매개 변수 속성

형식:Double
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DSTS

이 매개변수는 내부용으로만 사용됩니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Dsts
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-FindType

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

  • FindByThumbprint입니다. 인증서 지문으로 인증서를 찾습니다.
  • FindBySubjectName입니다. 주체 고유 이름 또는 일반 이름으로 인증서 저장소에서 인증서를 검색하고, 주체 고유 이름이 FindValue에 제공되는 경우 네이티브 Windows 암호화 API의 제한으로 인해 인증서의 주체 이름을 ASN 인코딩으로 인코딩해야 합니다. FindValue에 일반 이름이 제공되는 경우에는 이러한 제한이 없습니다.
  • FindBySubjectDistinguishedName
  • FindByIssuerName
  • FindByIssuerDistinguishedName
  • FindBySerialNumber
  • FindByTime유효
  • FindByTimeNotYetValid (FindByTimeNotYetValid)
  • FindByTime만료
  • FindByTemplateName (템플릿 이름 찾기)
  • FindByApplicationPolicy
  • FindByCertificatePolicy
  • FindByExtension
  • FindByKey사용법
  • FindBySubjectKeyIdentifier

매개 변수 속성

형식:X509FindType
Default value:None
허용되는 값:FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
와일드카드 지원:False
DontShow:False

매개 변수 집합

X509
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-FindValue

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

X509
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-GetMetadata

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Aad
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-HealthOperationTimeoutInSec

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

매개 변수 속성

형식:Double
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-HealthReportRetrySendIntervalInSec

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

매개 변수 속성

형식:Double
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-HealthReportSendIntervalInSec

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

매개 변수 속성

형식:Double
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Interactive

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

매개 변수 속성

형식:Boolean
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Dsts
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-KeepAliveIntervalInSec

연결 연결 유지 기간을 초 단위로 지정합니다. 이 간격은 비동기적으로 실행되는 작업 중에 비활성으로 인해 연결이 종료되는 것을 방지합니다.

매개 변수 속성

형식:Double
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MetaDataEndpoint

이 매개변수는 내부용으로만 사용됩니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Dsts
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-PartitionLocationCacheLimit

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

매개 변수 속성

형식:Int64
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SecurityToken

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Aad
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ServerCertThumbprint

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

X509
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
Dsts
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
Aad
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ServerCommonName

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

X509
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
Dsts
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
Aad
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ServiceChangePollIntervalInSec

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

매개 변수 속성

형식:Double
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SkipChecks

클러스터에 연결할 때 시스템 서비스 응답성 검증 검사를 무시하도록 표시합니다.

매개 변수 속성

형식:Boolean
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-StoreLocation

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

  • 현재 사용자
  • LocalMachine

매개 변수 속성

형식:StoreLocation
Default value:None
허용되는 값:CurrentUser, LocalMachine
와일드카드 지원:False
DontShow:False

매개 변수 집합

X509
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-StoreName

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

X509
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-TimeoutSec

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

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WindowsCredential

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Windows
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-X509Credential

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

X509
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

출력

System.Object