Partager via

Set-AzSqlServer

  • Référence
Module:
Az.Sql

Modifie les propriétés d’un serveur SQL Database.

Syntaxe

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>]
   [-Force]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-AzSqlServer modifie les propriétés d’un serveur Azure SQL Database.

Exemples

Exemple 1 : Réinitialiser le mot de passe administrateur

$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

Cette commande réinitialise le mot de passe administrateur sur le serveur AzureSQL nommé server01.

Exemple 2

Modifie les propriétés d’un serveur SQL Database. (généré automatiquement)

Set-AzSqlServer -AssignIdentity -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'

Paramètres

-AssignIdentity

Générez et attribuez une identité Microsoft Entra pour ce serveur à utiliser avec des services de gestion de clés comme Azure KeyVault.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FederatedClientId

Spécifie l’ID client fédéré du serveur lors de l’utilisation de CMK interlocataire, ne définissez pas cette valeur si vous n’avez pas l’intention d’utiliser CMK interlocataire

Type:Nullable<T>[Guid]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IdentityType

Type d’identité à affecter au serveur. Les valeurs possibles sont SystemAsssigned, UserAssigned, « SystemAssigned, UserAssigned » et None.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyId

URI Azure Key Vault utilisé pour le chiffrement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MinimalTlsVersion

Version TLS minimale à appliquer pour Sql Server

Type:String
Valeurs acceptées:None, 1.0, 1.1, 1.2
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PrimaryUserAssignedIdentityId

ID UMI (User Managed Identity) principal.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicNetworkAccess

Prend un indicateur, activé/désactivé, pour spécifier si l’accès au réseau public au serveur est autorisé ou non. En cas de désactivation, seules les connexions effectuées via des liaisons privées peuvent atteindre ce serveur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom du groupe de ressources auquel le serveur est affecté.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-RestrictOutboundNetworkAccess

En cas d’activation, seules les connexions sortantes autorisées par les règles de pare-feu sortantes réussissent.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerName

Spécifie le nom du serveur que cette applet de commande modifie.

Type:String
Alias:Name
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServerVersion

Spécifie la version à laquelle cette applet de commande modifie le serveur. Les valeurs acceptables pour ce paramètre sont les suivantes : 2.0 et 12.0.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SqlAdministratorPassword

Spécifie un nouveau mot de passe, en tant que SecureString, pour l’administrateur du serveur de base de données. Pour obtenir un SecureString, utilisez l’applet de commande Get-Credential. Pour plus d'informations, voir Get-Help ConvertTo-SecureString.

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tags

Spécifie un dictionnaire de balises que cette applet de commande associe au serveur. Paires clé-valeur sous la forme d’une table de hachage définie en tant que balises sur le serveur. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

Type:Hashtable
Alias:Tag
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserAssignedIdentityId

Liste des identités affectées par l’utilisateur.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Sorties

AzureSqlServerModel