Set-AzureSqlDatabase

Modulo:

Azure

Imposta le proprietà per un database SQL di Azure.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Set-AzureSqlDatabase imposta le proprietà per un database SQL di Azure. È possibile specificare il database in base al nome o passare un oggetto database SQL di Azure tramite la pipeline. È possibile specificare il server in base al nome o passare un contesto di connessione database SQL di Azure server. Creare un contesto di connessione eseguendo il cmdlet New-AzureSqlDatabaseServerContext . Se si specifica il server in base al nome, il cmdlet usa le informazioni correnti sulla sottoscrizione di Azure per autenticare la richiesta.

Esempio

Esempio 1: Modificare le dimensioni di un database usando un contesto di connessione

PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20

Questo esempio modifica le dimensioni del database denominato Database01 a 20 GB nel contesto di connessione del server database SQL di Azure $Context.

Esempio 2: Modificare le dimensioni di un database usando un nome del server

PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20

Questo esempio modifica le dimensioni del database denominato Database01 a 20 GB nel server denominato lpqd0zbr8y.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ConnectionContext

Specifica il contesto di connessione di un server.

Tipo:	IServerDataServiceContext
Alias:	Context
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Database

Specifica un oggetto che rappresenta il database SQL di Azure modificato da questo cmdlet.

Tipo:	Database
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DatabaseName

Specifica il nome del database modificato da questo cmdlet.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Edition

Specifica la nuova edizione per il database SQL di Azure. I valori validi sono:

• None
• Web
• Azienda
• Di base
• Standard
• Premium

Tipo:	DatabaseEdition
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Force

Consente il completamento dell'azione senza richiedere conferma.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MaxSizeBytes

Specifica le nuove dimensioni massime per il database in byte. È possibile specificare questo parametro o il parametro MaxSizeGB . Vedere il parametro MaxSizeGB per i valori accettabili in base all'edizione.

Tipo:	Int64
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MaxSizeGB

Specifica le nuove dimensioni massime per il database in gigabyte. È possibile specificare questo parametro o il parametro MaxSizeBytes . I valori accettabili differiscono in base all'edizione.

Valori di base dell'edizione: 1 o 2

edizione Standard valori: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200 o 250

Valori di Premium Edition: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200, 250, 300, 400 o 500

Valori dell'edizione Web: 1 o 5

Valori di Business Edition: 10, 20, 30, 40, 50, 100 o 150

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NewDatabaseName

Specifica il nuovo nome del database.

Tipo:	String
Alias:	NewName
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PassThru

Restituisce il database SQL di Azure aggiornato.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:	AzureSMProfile
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ServerName

Specifica il nome del server che contiene il database modificato da questo cmdlet.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ServiceObjective

Specifica un oggetto che rappresenta il nuovo obiettivo di servizio (livello di prestazioni) per questo database. I valori validi sono:

• 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-digita1-464b-b252-925be0a19446

*Standard (S3) fa parte dell'ultimo aggiornamento database SQL V12 (anteprima). Per altre informazioni, vedere Novità nell'anteprima di database SQL di Azure V12https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.

Tipo:	ServiceObjective
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Sync

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Output

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Collegamenti correlati

• Database SQL di Azure
• Operazioni per i database SQL di Azure
• Aggiornare il database
• Get-AzureSqlDatabase
• New-AzureSqlDatabase
• Remove-AzureSqlDatabase
• New-AzureSqlDatabaseServerContext