Set-AzureSqlDatabase
Azure SQL Database のプロパティを設定します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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>]
説明
Set-AzureSqlDatabase コマンドレットは、Azure SQL Database のプロパティを設定します。 名前でデータベースを指定するか、パイプラインを介して Azure SQL Database オブジェクトを渡すことができます。 サーバーを名前で指定するか、Azure SQL Database サーバー接続コンテキストを渡すことができます。 New-AzureSqlDatabaseServerContext コマンドレットを 実行して、接続コンテキストを 作成します。 サーバーを名前で指定した場合、コマンドレットは現在の Azure サブスクリプション情報を使用して要求を認証します。
例
例 1: 接続コンテキストを使用してデータベースのサイズを変更する
PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20
この例では、Azure SQL Database サーバー接続コンテキストで Database01 という名前のデータベースのサイズを 20 GB に変更$Context。
例 2: サーバー名を使用してデータベースのサイズを変更する
PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20
次の使用例は、lpqd0zbr8y という名前のサーバーの Database01 という名前のデータベースのサイズを 20 GB に変更します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionContext
サーバーの接続コンテキストを指定します。
Type: | IServerDataServiceContext |
Aliases: | Context |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Database
このコマンドレットが変更する Azure SQL Database を表すオブジェクトを指定します。
Type: | Database |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DatabaseName
このコマンドレットが変更するデータベースの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Edition
Azure SQL Database の新しいエディションを指定します。 有効な値は次のとおりです。
- なし
- Web
- Business
- Basic
- Standard
- Premium
Type: | DatabaseEdition |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
確認を求めずにアクションを完了できるようにします。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxSizeBytes
データベースの新しい最大サイズをバイト単位で指定します。 このパラメーターまたは MaxSizeGB パラメーターを指定できます。 エディションに 基づく許容値については、MaxSizeGB パラメーターを参照してください。
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxSizeGB
データベースの新しい最大サイズをギガバイト単位で指定します。 このパラメーターまたは MaxSizeBytes パラメーターを指定できます。 許容される値は、エディションによって異なります。
基本エディションの値: 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 エディションの値: 1 または 5
Business Edition の値: 10、20、30、40、50、100、または 150
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewDatabaseName
データベースの新しい名前を指定します。
Type: | String |
Aliases: | NewName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
更新された Azure SQL Database を返します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerName
このコマンドレットが変更するデータベースを含むサーバーの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceObjective
このデータベースの新しいサービス目標 (パフォーマンス レベル) を表すオブジェクトを指定します。 有効な値は次のとおりです。
- Basic: dd6d99bb-f193-4ec1-86f2-43d3bccbc49c
- Standard (S0): f1173c43-91bd-4aaa-973c-54e79e15235b
- Standard (S1): 1b1ebd4d-d903-4baa-97f9-4ea675f5e928
- Standard (S2): 455330e1-00cd-488b-b5fa-177c226f28b7
- *Standard (S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40
- Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d
- Premium (P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0
- Premium (P3): a7c4c615-cfb1-464b-b252-925be0a19446
*Standard (S3) は、最新の SQL Database Update V12 (プレビュー) の一部です。 詳細については、「Azure SQL Database V12 プレビューの新機能」を参照してください。https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.
Type: | ServiceObjective |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Sync
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
出力
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database