Set-AzureSqlDatabase
Azure SQL Database에 대한 속성을 설정합니다.
참고 항목
이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.
Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.
구문
Set-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-DatabaseName <String>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-Database <Database>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureSqlDatabase
-ServerName <String>
-DatabaseName <String>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureSqlDatabase
-ServerName <String>
-Database <Database>
[-NewDatabaseName <String>]
[-Edition <DatabaseEdition>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-ServiceObjective <ServiceObjective>]
[-PassThru]
[-Force]
[-Sync]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzureSqlDatabase cmdlet은 Azure SQL Database에 대한 속성을 설정합니다. 이름으로 데이터베이스를 지정하거나 파이프라인을 통해 Azure SQL Database 개체를 전달할 수 있습니다. 이름으로 서버를 지정하거나 Azure SQL Database 서버 연결 컨텍스트를 전달할 수 있습니다. New-AzureSqlDatabaseServerContext cmdlet을 실행 하여 연결 컨텍스트를 만듭니다. 이름으로 서버를 지정하는 경우 cmdlet은 현재 Azure 구독 정보를 사용하여 요청을 인증합니다.
예제
예제 1: 연결 컨텍스트를 사용하여 데이터베이스 크기 변경
PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20
다음은 $Context Azure SQL Database 서버 연결 컨텍스트에서 Database01이라는 데이터베이스의 크기를 20GB로 변경하는 예제입니다.
예제 2: 서버 이름을 사용하여 데이터베이스 크기 변경
PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20
다음은 lpqd0zbr8y 서버에서 Database01이라는 데이터베이스의 크기를 20GB로 변경하는 예제입니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ConnectionContext
서버의 연결 컨텍스트를 지정합니다.
형식: | IServerDataServiceContext |
별칭: | Context |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Database
이 cmdlet에서 수정하는 Azure SQL Database를 나타내는 개체를 지정합니다.
형식: | Database |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-DatabaseName
이 cmdlet에서 수정하는 데이터베이스의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Edition
Azure SQL Database에 대한 새 버전을 지정합니다. 유효한 값은 다음과 같습니다.
- None
- 웹
- 비즈니스
- Basic
- Standard
- Premium
형식: | 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 |
-NewDatabaseName
데이터베이스의 새 이름을 지정합니다.
형식: | String |
별칭: | NewName |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PassThru
업데이트된 Azure SQL Database를 반환합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Profile
이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.
형식: | AzureSMProfile |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ServerName
이 cmdlet에서 수정하는 데이터베이스를 포함하는 서버의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-ServiceObjective
이 데이터베이스의 새 서비스 목표(성능 수준)를 나타내는 개체를 지정합니다. 유효한 값은 다음과 같습니다.
- 기본: dd6d99bb-f193-4ec1-86f2-43d3bccbc49c
- 표준(S0): f1173c43-91bd-4aaa-973c-54e79e15235b
- 표준(S1): 1b1ebd4d-d903-4baa-97f9-4ea675f5e928
- 표준(S2): 455330e1-00cd-488b-b5fa-177c226f28b7
- *Standard(S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40
- 프리미엄(P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d
- 프리미엄(P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0
- 프리미엄(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 |
-Sync
형식: | SwitchParameter |
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
출력
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database