New-AzureSqlDatabase
Azure SQL Database를 만듭니다.
참고 항목
이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.
Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.
구문
New-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-DatabaseName <String>
[-Collation <String>]
[-Edition <DatabaseEdition>]
[-ServiceObjective <ServiceObjective>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureSqlDatabase
-ServerName <String>
-DatabaseName <String>
[-Collation <String>]
[-Edition <DatabaseEdition>]
[-ServiceObjective <ServiceObjective>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-AzureSqlDatabase cmdlet은 Azure SQL Database를 만듭니다. New-AzureSqlDatabaseServerContext cmdlet을 사용하여 만든 Azure SQL Database 서버 연결 컨텍스트를 사용하여 서버를 지정할 수 있습니다. 또는 서버 이름을 지정하는 경우 cmdlet은 현재 Azure 구독 정보를 사용하여 서버에 액세스하기 위한 요청을 인증합니다.
Azure SQL Database 서버를 지정하여 새 데이터베이스를 만들 때 New-AzureSqlDatabase cmdlet은 지정된 서버 이름과 현재 Azure 구독 정보를 사용하여 임시 연결 컨텍스트를 만들어 작업을 수행합니다.
예제
예제 1: 데이터베이스 만들기
PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"이 명령은 Azure SQL Database 서버 연결 컨텍스트 $Context Database1이라는 Azure SQL Database를 만듭니다.
예제 2: 현재 구독에서 데이터베이스 만들기
PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"이 예제에서는 lpqd0zbr8y라는 지정된 Azure SQL Database 서버에 Database1이라는 데이터베이스를 만듭니다. cmdlet은 현재 Azure 구독 정보를 사용하여 서버에 액세스하기 위한 요청을 인증합니다.
매개 변수
-Collation
새 데이터베이스에 대한 데이터 정렬을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ConnectionContext
이 cmdlet이 데이터베이스를 만드는 서버의 연결 컨텍스트를 지정합니다.
| 형식: | IServerDataServiceContext |
| 별칭: | Context |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DatabaseName
새 데이터베이스의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Edition
새 Azure SQL Database의 버전을 지정합니다. 유효한 값은 다음과 같습니다.
- None
- 웹
- 비즈니스
- Basic
- Standard
- Premium
기본값은 Web입니다.
| 형식: | DatabaseEdition |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Force
사용자에게 확인을 요청하지 않고 작업을 완료할 수 있습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaxSizeBytes
데이터베이스의 최대 크기(바이트)를 지정합니다. 이 매개 변수 또는 MaxSizeGB 매개 변수를 지정할 수 있습니다. 버전에 따라 허용되는 값은 MaxSizeGB 매개 변수 설명을 참조하세요.
| 형식: | Int64 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaxSizeGB
데이터베이스의 최대 크기(기가바이트)를 지정합니다. 이 매개 변수 또는 MaxSizeBytes 매개 변수를 지정할 수 있습니다. 허용되는 값은 버전에 따라 다릅니다.
Basic Edition 값: 1 또는 2
Standard Edition 값: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200 또는 250
Premium Edition 값: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200, 250, 300, 400 또는 500
Web Edition 값: 1 또는 5
Business Edition 값: 10, 20, 30, 40, 50, 100 또는 150
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Profile
이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.
| 형식: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ServerName
새 데이터베이스를 포함할 Azure SQL Database 서버의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ServiceObjective
이 데이터베이스의 새 서비스 목표(성능 수준)를 나타내는 개체를 지정합니다. 이 값은 이 데이터베이스에 할당된 리소스의 수준을 나타냅니다. 유효한 값은 다음과 같습니다.
기본: dd6d99bb-f193-4ec1-86f2-43d3bccbc49c Standard(S0): f1173c43-91bd-4aaa-973c-54e79e15235b Standard(S1): 1b1ebd4d-d 903-4baa-97f9-4ea675f5e928 Standard(S2): 455330e1-00cd-488b-b5fa-177c226f28b7 *Standard(S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40 Premium(P1): 7203483a-c4fb-4304-9e9f-17c904f5d Premium(P1): 7203483a-c4fb-4304-9e9f-1 7c71c904f5d Premium(P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0 Premium(P3): a7c4c615-cfb1-464b-b252-925be0a19446
*Standard(S3)는 최신 SQL Database 업데이트 V12(미리 보기)의 일부입니다. 자세한 내용은 Azure SQL Database V12 미리 보기의 새로운 기능https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.
| 형식: | ServiceObjective |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
출력
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
참고
- New-AzureSqlDatabase에서 만든 데이터베이스를 삭제하려면 Remove-AzureSqlDatabase cmdlet을 사용합니다.