Set-AzSqlServer
Modifica le proprietà di un server di database SQL.
Sintassi
Default (Impostazione predefinita)
Set-AzSqlServer
[-ServerName] <String>
[-SqlAdministratorPassword <SecureString>]
[-Tags <Hashtable>]
[-ServerVersion <String>]
[-AssignIdentity]
[-PublicNetworkAccess <String>]
[-RestrictOutboundNetworkAccess <String>]
[-MinimalTlsVersion <String>]
[-PrimaryUserAssignedIdentityId <String>]
[-KeyId <String>]
[-FederatedClientId <Guid>]
[-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
[-IdentityType <String>]
[-EnableSoftDelete <Boolean>]
[-SoftDeleteRetentionDays <Int32>]
[-Force]
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Set-AzSqlServer modifica le proprietà di un server di database SQL di Azure.
Esempio
Esempio 1: Reimpostare la password dell'amministratore
$SecureString = ConvertTo-SecureString -String "****" -AsPlainText -Force
Set-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -SqlAdministratorPassword $secureString
ResourceGroupName : ResourceGroup01
ServerName : Server01
Location : Australia East
SqlAdministratorLogin : adminLogin
SqlAdministratorPassword :
ServerVersion : 12.0
Tags :
Identity :
FullyQualifiedDomainName : server01.database.windows.net
Questo comando reimposta la password dell'amministratore nel server AzureSQL denominato server01.
Esempio 2: modifica le proprietà di un server di database SQL. (autogenerated)
Set-AzSqlServer -AssignIdentity -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'
Esempio 3: Abilitare la conservazione dell'eliminazione temporanea per il server (impostazione predefinita 7 giorni)
Set-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -EnableSoftDelete $true
ResourceGroupName : ResourceGroup01
ServerName : Server01
Location : centralus
SqlAdministratorLogin : SqlAdminUser
SqlAdministratorPassword :
ServerVersion : 12.0
Tags :
Identity :
FullyQualifiedDomainName : Server01.database.windows.net
MinimalTlsVersion : 1.2
PublicNetworkAccess : Enabled
RestrictOutboundNetworkAccess : Disabled
Administrators :
PrimaryUserAssignedIdentityId :
KeyId :
FederatedClientId :
SoftDeleteRetentionDays : 7
Questo comando abilita la conservazione dell'eliminazione temporanea in Azure SQL Server denominato server01, con un periodo di conservazione predefinito di 7 giorni. Per personalizzare la durata di conservazione, usare il parametro SoftDeleteRetentionDays.
Esempio 4: Disabilitare la conservazione dell'eliminazione temporanea per il server
Set-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -EnableSoftDelete $false -SoftDeleteRetentionDays 0
ResourceGroupName : ResourceGroup01
ServerName : Server01
Location : centralus
SqlAdministratorLogin : SqlAdminUser
SqlAdministratorPassword :
ServerVersion : 12.0
Tags :
Identity :
FullyQualifiedDomainName : Server01.database.windows.net
MinimalTlsVersion : 1.2
PublicNetworkAccess : Enabled
RestrictOutboundNetworkAccess : Disabled
Administrators :
PrimaryUserAssignedIdentityId :
KeyId :
FederatedClientId :
SoftDeleteRetentionDays : 0
Questo comando disabilita la conservazione dell'eliminazione temporanea in Azure SQL Server denominato server01.
Parametri
-AssignIdentity
Generare e assegnare un'identità Microsoft Entra per questo server da usare con i servizi di gestione delle chiavi come Azure KeyVault.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: False
Supporta i caratteri jolly: False
DontShow: False
Alias: cfr
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure
Proprietà dei parametri
Tipo: IAzureContextContainer
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-EnableSoftDelete
Valore booleano che indica se abilitare o meno l'eliminazione temporanea per il server in modo che il server possa essere ripristinato per un valore predefinito di 7 giorni dopo l'eliminazione. Se si desidera specificare un periodo di conservazione diverso, usare il parametro SoftDeleteRetentionDays.
Proprietà dei parametri
Tipo: Boolean
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-FederatedClientId
Specifica l'ID client federato del server quando si usa cmk multi-tenant, non impostare questo valore se non si intende usare cmk multi-tenant
Proprietà dei parametri
Tipo: Nullable<T> [ Guid ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Force
Forza l'esecuzione del comando senza chiedere conferma dell'utente.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-IdentityType
Tipo di identità da assegnare al server. I valori possibili sono SystemAssigned, UserAssigned, 'SystemAssigned,UserAssigned' e Nessuno.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-KeyId
URI di Azure Key Vault usato per la crittografia.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-MinimalTlsVersion
Versione minima di TLS da applicare per Sql Server
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Valori accettati: None, 1.0, 1.1, 1.2
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-PrimaryUserAssignedIdentityId
ID UMI (User Managed Identity) primario.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-PublicNetworkAccess
Accetta un flag, abilitato/disabilitato, per specificare se l'accesso alla rete pubblica al server è consentito o meno.
Se disabilitato, solo le connessioni effettuate tramite collegamenti privati possono raggiungere questo server.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ResourceGroupName
Specifica il nome del gruppo di risorse a cui è assegnato il server.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: 0
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-RestrictOutboundNetworkAccess
Se abilitata, solo le connessioni in uscita consentite dalle regole del firewall in uscita avranno esito positivo.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ServerName
Specifica il nome del server modificato da questo cmdlet.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: Nome
Set di parametri
(All)
Posizione: 1
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: True
Valore dagli argomenti rimanenti: False
-ServerVersion
Specifica la versione in cui il cmdlet modifica il server. I valori accettabili per questo parametro sono: 2.0 e 12.0.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-SoftDeleteRetentionDays
Valore per i giorni di conservazione dell'eliminazione temporanea per il server in modo che il server possa essere ripristinato per il numero specificato di giorni dopo l'eliminazione. Solo i valori validi sono compresi tra 0 e 35. Se impostato su 0, la conservazione dell'eliminazione temporanea è disabilitata.
Proprietà dei parametri
Tipo: Nullable<T> [ Int32 ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-SqlAdministratorPassword
Specifica una nuova password, come SecureString , per l'amministratore del server di database. Per ottenere un oggetto SecureString , usare il cmdlet Get-Credential. Per altre informazioni, digitare Get-Help ConvertTo-SecureString.
Proprietà dei parametri
Tipo: SecureString
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
Specifica un dizionario di tag associati al server da questo cmdlet. Coppie chiave-valore sotto forma di tabella hash impostata come tag nel server. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}
Tipo: Hashtable
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: Tag
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-UserAssignedIdentityId
Elenco delle identità assegnate dall'utente.
Proprietà dei parametri
Tipo: List<T> [ String ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet.
Il cmdlet non viene eseguito.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: False
Supporta i caratteri jolly: False
DontShow: False
Alias: Wi
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters .
Output