Set-AzSqlServer
Modifica las propiedades de un servidor de SQL Database.
Sintaxis
Default (valor predeterminado)
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>]
Description
El cmdlet Set-AzSqlServer modifica las propiedades de un servidor de Azure SQL Database.
Ejemplos
Ejemplo 1: Restablecimiento de la contraseña de administrador
$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
Este comando restablece la contraseña de administrador en el servidor AzureSQL denominado server01.
Ejemplo 2: Modifica las propiedades de un servidor de SQL Database. (autogenerated)
Set-AzSqlServer -AssignIdentity -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'
Ejemplo 3: Habilitar la retención de eliminación temporal para el servidor (valor predeterminado 7 días)
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
Este comando habilita la retención de eliminación temporal en Azure SQL Server denominado server01, con un período de retención predeterminado de 7 días. Para personalizar la duración de retención, use el parámetro SoftDeleteRetentionDays.
Ejemplo 4: Deshabilitar la retención de eliminación temporal para el servidor
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
Este comando deshabilita la retención de eliminación temporal en Azure SQL Server denominado server01.
Parámetros
-AssignIdentity
Genere y asigne una identidad de Microsoft Entra para este servidor para usarla con servicios de administración de claves como Azure KeyVault.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: False Admite caracteres comodín: False DontShow: False Alias: cf
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure
Propiedades de parámetro
Tipo: IAzureContextContainer
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-EnableSoftDelete
Valor booleano para si se va a habilitar o no la eliminación temporal para el servidor de forma que el servidor se pueda restaurar durante un valor predeterminado de 7 días después de la eliminación. Si desea especificar un período de retención diferente, use el parámetro SoftDeleteRetentionDays.
Propiedades de parámetro
Tipo: Boolean
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-FederatedClientId
Especifica el identificador de cliente federado del servidor cuando se usa CMK entre inquilinos, no establezca este valor si no tiene intención de usar CMK entre inquilinos.
Propiedades de parámetro
Tipo: Nullable<T> [ Guid ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Force
Obliga a que el comando se ejecute sin pedir confirmación del usuario.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-IdentityType
Tipo de identidad que se va a asignar al servidor. Los valores posibles son SystemAssigned, UserAssigned, 'SystemAssigned,UserAssigned' y None.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-KeyId
URI de Azure Key Vault que se usa para el cifrado.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-MinimalTlsVersion
La versión mínima de TLS que se va a aplicar para Sql Server
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Valores aceptados: None, 1.0, 1.1, 1.2 Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-PrimaryUserAssignedIdentityId
Identificador de identidad administrada del usuario principal (UMI).
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-PublicNetworkAccess
Toma una marca, habilitada o deshabilitada, para especificar si se permite o no el acceso de red pública al servidor.
Cuando está deshabilitado, solo las conexiones realizadas a través de Private Links pueden llegar a este servidor.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ResourceGroupName
Especifica el nombre del grupo de recursos al que se asigna el servidor.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: 0 Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-RestrictOutboundNetworkAccess
Cuando se habilita, solo las conexiones salientes permitidas por las reglas de firewall de salida se realizarán correctamente.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ServerName
Especifica el nombre del servidor que modifica este cmdlet.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: Nombre
Conjuntos de parámetros
(All)
Posición: 1 Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-ServerVersion
Especifica la versión a la que cambia el servidor este cmdlet. Los valores aceptables para este parámetro son: 2.0 y 12.0.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-SoftDeleteRetentionDays
Valor para los días de retención de eliminación temporal para el servidor de modo que el servidor se pueda restaurar durante el número de días especificado después de la eliminación. Solo los valores válidos son de 0 a 35. Si se establece en 0, la retención de eliminación temporal está deshabilitada.
Propiedades de parámetro
Tipo: Nullable<T> [ Int32 ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-SqlAdministratorPassword
Especifica una nueva contraseña, como SecureString , para el administrador del servidor de bases de datos. Para obtener un secureString , use el cmdlet Get-Credential. Para obtener más información, escriba Get-Help ConvertTo-SecureString.
Propiedades de parámetro
Tipo: SecureString
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
Especifica un diccionario de etiquetas que este cmdlet asocia al servidor. Pares clave-valor en forma de tabla hash establecida como etiquetas en el servidor. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}
Tipo: Hashtable
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: Etiqueta
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-UserAssignedIdentityId
Lista de identidades asignadas por el usuario.
Propiedades de parámetro
Tipo: List<T> [ String ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta.
El cmdlet no se ejecuta.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: False Admite caracteres comodín: False DontShow: False Alias: Wi
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas
