New-SBFarm
업데이트 날짜: 2014년 3월
New-SBFarm
이 cmdlet을 사용하여 새 Service Bus for Windows Server 팜을 만들 수 있습니다.
구문
Parameter Set: AutoCert
New-SBFarm -CertificateAutoGenerationKey <SecureString> -SBFarmDBConnectionString <String> [-AdminApiCredentials <PSCredential> ] [-AdminGroup <String> ] [-AmqpPort <Int32> ] [-AmqpsPort <Int32> ] [-FarmDns <String> ] [-GatewayDBConnectionString <String> ] [-HttpsPort <Int32> ] [-InternalPortRangeStart <Int32> ] [-MessageBrokerPort <Int32> ] [-MessageContainerDBConnectionString <String> ] [-RPHttpsPort <Int32> ] [-RunAsAccount <String> ] [-TcpPort <Int32> ] [-TenantApiCredentials <PSCredential> ] [ <CommonParameters>]
Parameter Set: CustomCert
New-SBFarm -FarmCertificateThumbprint <String> -SBFarmDBConnectionString <String> [-AdminApiCredentials <PSCredential> ] [-AdminGroup <String> ] [-AmqpPort <Int32> ] [-AmqpsPort <Int32> ] [-EncryptionCertificateThumbprint <String> ] [-FarmDns <String> ] [-GatewayDBConnectionString <String> ] [-HttpsPort <Int32> ] [-InternalPortRangeStart <Int32> ] [-MessageBrokerPort <Int32> ] [-MessageContainerDBConnectionString <String> ] [-RPHttpsPort <Int32> ] [-RunAsAccount <String> ] [-TcpPort <Int32> ] [-TenantApiCredentials <PSCredential> ] [ <CommonParameters>]
자세한 설명
이 New-SBFarm 을 실행하여 새 Service Bus for Windows Server 팜을 만듭니다. 이 단계는 Service Bus for Windows Server를 시작하는 데 필요한 첫 번째 단계입니다. 팜은 팜 관리 데이터베이스에 저장된 Service Bus for Windows Server 구성으로, 여기에는 설정 및 메시지를 저장하는 데 사용되는 데이터베이스, 클라이언트와 외부적으로 사용할 포트, 팜의 호스트 간 내부적으로 사용할 포트 등과 같은, Service Bus for Windows Server에 필요한 설정이 포함됩니다.
그리고 FarmCertificateThumbprint 및 EncryptionCertificateThumbprint (SSL용) 매개 변수의 경우 모두, New-SBFarm cmdlet은 사용할 인증서의 손도장이 포함된 문자열이 통과할 것을 예상합니다. 이러한 매개 변수는 자신이 소유한 인증서를 사용할 계획이라면 필요합니다. 호출하기 전에 인증서가 LocalMachine 인증서 저장소에 있어야 합니다. New-SBFarm.
팜을 만드는 동안 오류가 발생하거나 강제로 다시 부팅되는 경우, 만들어진 데이터베이스가 손상될 수 있습니다. 이 경우 팜에 가입하려고 할 때 프로세스에, 팜에 추가하려는 컴퓨터가 어떠한 팜에도 속해 있지 않음을 나타내는 오류가 표시될 수 있습니다. 이러한 오류가 표시될 경우 새 노드를 팜에 연결하려면 데이터베이스를 삭제하고 다시 만들어야 합니다.
Windows Azure Pack 관리 포털에서 관리되는 서비스 버스 팜을 만들 수 있습니다. 이 구성을 사용하도록 설정하려면 서비스 버스 리소스 공급자와 Windows Azure Pack 포털 간에 기본 인증 설정을 지정해야 합니다. 여기에는 관리 API는 물론 테넌트 API에 대한 설정도 포함됩니다.
매개 변수
-AdminApiCredentials<PSCredential>
리소스 공급자 자격 증명을 설정합니다. 리소스 공급자는 관리 API를 포털에 표시하는 구성 요소입니다. Service Bus 관리 포털에는 관리 포털(팜 관리를 위해 일련의 리소스 공급자 API 제공)과 테넌트 포털(Azure 관리 포털), 두 가지가 있습니다. 수동으로 서버 팜을 설치하고 관리 포털에 연결할 경우 이 자격 증명을 사용합니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-AdminGroup<String>
관리자 그룹을 나타냅니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
BUILTIN\Administrators |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-AmqpPort<Int32>
이 선택적 매개 변수는 AMQP 포트를 설정합니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-AmqpsPort<Int32>
이 선택적 매개 변수는 AMQP SSL 포트를 설정합니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-CertificateAutoGenerationKey<SecureString>
이 암호는 인증서 자동 생성 시 필요합니다. 인증서를 자동 생성하려면 이 매개 변수는 필수입니다.
별칭 |
없음 |
필수 여부 |
true |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-EncryptionCertificateThumbprint<String>
이 인증서는 SQL 연결 문자열을 보호하는 데 사용됩니다. 인증서가 제공되지 않을 경우 SslCertificate의 값이 사용됩니다. 암호화 인증서를 나타냅니다.
그리고 FarmCertificateThumbprint 및 EncryptionCertificateThumbprint (SSL용) 매개 변수의 경우 모두, New-SBFarm cmdlet은 사용할 인증서의 손도장이 포함된 문자열이 통과할 것을 예상합니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-FarmCertificateThumbprint<String>
인증서에 대해 보안을 설정하는 데 사용되는 인증서를 나타냅니다. 인증서를 자동 생성하기 위해 CertificateAutoGenerationKey를 제공하는 경우에는 이 인증서를 제공하지 마십시오.
그리고 FarmCertificateThumbprint 및 EncryptionCertificateThumbprint (SSL용) 매개 변수의 경우 모두, New-SBFarm cmdlet은 사용할 인증서의 손도장이 포함된 문자열이 통과할 것을 예상합니다.
별칭 |
없음 |
필수 여부 |
true |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-FarmDns<String>
모든 서버 팜 노드에 매핑되는 DNS 접두사입니다. 이 cmdlet은 관리자가 서버 팜을 등록할 때 사용됩니다. 연결 문자열을 요청하기 위해 Get-SBClientConfiguration cmdlet을 호출할 경우 서버 팜 노드 값이 반환됩니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-GatewayDBConnectionString<String>
게이트웨이 데이터베이스의 연결 문자열을 나타냅니다. 전달되지 않으면 기본 이름이 “SBGatewayDatabase”인 SBFarmDBConnectionString을 사용하여 동일한 SQL Server에서 만들어집니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
SBGatewayDatabase |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-HttpsPort<Int32>
Service Bus for Windows Server에서 HTTPS 통신에 사용하는 포트를 나타냅니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
9355 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-InternalPortRangeStart<Int32>
Service Bus for Windows Server에서 내부 통신용으로 사용하는 포트 범위 시작을 나타냅니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
9000-004 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-MessageBrokerPort<Int32>
Service Bus for Windows Server에서 MessageBroker 통신에 사용하는 포트를 나타냅니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
9356 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-MessageContainerDBConnectionString<String>
메시지 컨테이너의 연결 문자열을 나타냅니다. 전달되지 않으면 기본 이름이 "SBMessageContainer01”인 SBFarmDBConnectionString을 사용하여 동일한 SQL Server에서 만들어집니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
SBMessageContainer01 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-RPHttpsPort<Int32>
이 선택적 매개 변수는 리소스 공급자 포트 설정을 지정합니다. 이 포트는 포털에서 서비스 버스 팜에 액세스하는 데 사용됩니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-RunAsAccount<String>
서비스를 실행하는 데 사용되는 계정을 나타냅니다. 이 계정은 도메인 계정이어야 합니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
The account under which configuration is run |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-SBFarmDBConnectionString<String>
Service Bus for Windows Server 데이터베이스의 연결 문자열을 나타냅니다.
별칭 |
없음 |
필수 여부 |
true |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-TcpPort<Int32>
Service Bus for Windows Server에서 TCP에 대해 사용하는 포트를 나타냅니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
9354 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-TenantApiCredentials<PSCredential>
테넌트 포털의 리소스 공급자 자격 증명을 설정합니다. 리소스 공급자는 관리 API를 포털에 표시하는 구성 요소입니다. Service Bus 관리 포털에는 관리 포털(팜 관리를 위해 일련의 리소스 공급자 API 제공)과 테넌트 포털(Azure 관리 포털), 두 가지가 있습니다. 수동으로 서버 팜을 설치하고 테넌트 포털에 연결할 경우 이 자격 증명을 사용합니다.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)
입력
입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.
출력
출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.
예
예제 1
기본 설정으로 새 Service Bus for Windows Server 팜을 만듭니다. 이 팜은 로컬 호스트 SQLExpress 데이터베이스를 사용하며, 3개의 데이터베이스(ManagementDB, GatewayDB 및 MessageContainer1)를 만듭니다.
PS C:\> $mycert=ConvertTo-SecureString -string myPassword1 -force –AsPlainText; New-SBFarm -SBFarmDBConnectionString 'Data Source=localhost\sqlexpress;Integrated Security=True' -CertificateAutoGenerationKey $mycert
예제 2
관리 및 게이트웨이 데이터베이스가 MySQLServer 서버에 배치되어 있고 초기 메시지 컨테이너 데이터베이스가 myDedicatedMessagingSQLServer 서버에 배치되어 있는 새 Service Bus for Windows Server 팜을 만듭니다. Service Bus for Windows Server 서비스가 myServiceAccount 도메인 계정에서 실행되고 관리 권한이 myAdminsGroup Active Directory 사용자 그룹에 부여됩니다.
PS C:\> $mycert=ConvertTo-SecureString -string myPassword1 -force –AsPlainText; New-SBFarm -SBFarmDBConnectionString 'Data Source=mySQLServer;Integrated Security=True' –RunAsAccount myServiceAccount –AdminGroup myAdminsGroup –MessageContainerDBConnectionString 'Data Source=myDedicatedMessagingSQLServer;Integrated Security=True' –CertificateAutoGenerationKey $mycert