Set-AzSqlInstance

Module:: Az.Sql Module

Définit les propriétés d’une instance managée Azure SQL.

Syntaxe

SetInstanceFromInputParameters (Par défaut)

Set-AzSqlInstance
    [-Name] <String>
    [-ResourceGroupName] <String>
    [-AdministratorPassword <SecureString>]
    [-Edition <String>]
    [-IsGeneralPurposeV2 <Boolean>]
    [-SubnetId <String>]
    [-LicenseType <String>]
    [-StorageSizeInGB <Int32>]
    [-StorageIOps <Int32>]
    [-VCore <Int32>]
    [-MemorySizeInGB <Int32>]
    [-PublicDataEndpointEnabled <Boolean>]
    [-ProxyOverride <String>]
    [-Tag <Hashtable>]
    [-AssignIdentity]
    [-InstancePoolName <String>]
    [-MinimalTlsVersion <String>]
    [-PrimaryUserAssignedIdentityId <String>]
    [-KeyId <String>]
    [-Force]
    [-ComputeGeneration <String>]
    [-MaintenanceConfigurationId <String>]
    [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
    [-IdentityType <String>]
    [-BackupStorageRedundancy <String>]
    [-AsJob]
    [-ZoneRedundant]
    [-ServicePrincipalType <String>]
    [-DatabaseFormat <String>]
    [-PricingModel <String>]
    [-AuthenticationMetadata <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetInstanceFromAzureSqlManagedInstanceModelInstanceDefinition

Set-AzSqlInstance
    [-InputObject] <AzureSqlManagedInstanceModel>
    [-AdministratorPassword <SecureString>]
    [-Edition <String>]
    [-IsGeneralPurposeV2 <Boolean>]
    [-SubnetId <String>]
    [-LicenseType <String>]
    [-StorageSizeInGB <Int32>]
    [-StorageIOps <Int32>]
    [-VCore <Int32>]
    [-MemorySizeInGB <Int32>]
    [-PublicDataEndpointEnabled <Boolean>]
    [-ProxyOverride <String>]
    [-Tag <Hashtable>]
    [-AssignIdentity]
    [-InstancePoolName <String>]
    [-MinimalTlsVersion <String>]
    [-PrimaryUserAssignedIdentityId <String>]
    [-KeyId <String>]
    [-Force]
    [-ComputeGeneration <String>]
    [-MaintenanceConfigurationId <String>]
    [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
    [-IdentityType <String>]
    [-BackupStorageRedundancy <String>]
    [-AsJob]
    [-ZoneRedundant]
    [-ServicePrincipalType <String>]
    [-DatabaseFormat <String>]
    [-PricingModel <String>]
    [-AuthenticationMetadata <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetInstanceFromAzureResourceId

Set-AzSqlInstance
    [-ResourceId] <String>
    [-AdministratorPassword <SecureString>]
    [-Edition <String>]
    [-IsGeneralPurposeV2 <Boolean>]
    [-SubnetId <String>]
    [-LicenseType <String>]
    [-StorageSizeInGB <Int32>]
    [-StorageIOps <Int32>]
    [-VCore <Int32>]
    [-MemorySizeInGB <Int32>]
    [-PublicDataEndpointEnabled <Boolean>]
    [-ProxyOverride <String>]
    [-Tag <Hashtable>]
    [-AssignIdentity]
    [-InstancePoolName <String>]
    [-MinimalTlsVersion <String>]
    [-PrimaryUserAssignedIdentityId <String>]
    [-KeyId <String>]
    [-Force]
    [-ComputeGeneration <String>]
    [-MaintenanceConfigurationId <String>]
    [-UserAssignedIdentityId <System.Collections.Generic.List`1[System.String]>]
    [-IdentityType <String>]
    [-BackupStorageRedundancy <String>]
    [-AsJob]
    [-ZoneRedundant]
    [-ServicePrincipalType <String>]
    [-DatabaseFormat <String>]
    [-PricingModel <String>]
    [-AuthenticationMetadata <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Set-AzSqlInstance modifie les propriétés d’une instance managée Azure SQL.

Exemples

Exemple 1 : Définir une instance existante à l’aide de nouvelles valeurs pour -AdministratorPassword, -LicenseType, -StorageSizeInGB, -VCore et -Edition

$SecureString = ConvertTo-SecureString -String "****" -AsPlainText -Force
Set-AzSqlInstance -Name "managedinstance1" -ResourceGroupName "ResourceGroup01" -AdministratorPassword $SecureString -LicenseType LicenseIncluded -StorageSizeInGB 1024 -VCore 16 -Edition BusinessCritical

Location                 : westcentralus
Id                       : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName        : resourcegroup01
ManagedInstanceName      : managedInstance1
Tags                     :
Identity                 : Microsoft.Azure.Management.Sql.Models.ResourceIdentity
Sku                      : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2       :
FullyQualifiedDomainName : managedInstance1.wcusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin       : adminLogin1
AdministratorPassword    :
SubnetId                 : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
LicenseType              : LicenseIncluded
VCores                   : 16
MemorySizeInGB           :
StorageSizeInGB          : 1024
StorageIOps              :
InstancePoolName         :

Exemple 2 : Modifier la génération de matériel d’instance existante à l’aide de la nouvelle valeur pour -ComputeGeneration

Set-AzSqlInstance -Name "managedinstance1" -ResourceGroupName "ResourceGroup01" -ComputeGeneration Gen5

Location                 : westcentralus
Id                       : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName        : resourcegroup01
ManagedInstanceName      : managedInstance1
Tags                     :
Identity                 : Microsoft.Azure.Management.Sql.Models.ResourceIdentity
Sku                      : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2       :
FullyQualifiedDomainName : managedInstance1.wcusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin       : adminLogin1
AdministratorPassword    :
SubnetId                 : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
LicenseType              : LicenseIncluded
VCores                   : 16
MemorySizeInGB           :
StorageSizeInGB          : 1024
StorageIOps              :
InstancePoolName         :

Cette commande définit l’instance existante à l’aide de nouvelles valeurs pour -AdministratorPassword, -LicenseType, -StorageSizeInGB et -VCore

Exemple 3 : Remplacez l’instance existante par GPv2 en définissant de nouvelles valeurs pour -Edition, -ComputeGeneration, -IsGeneralPurposeV2. Définissez également de nouvelles valeurs pour -VCore, StorageSizeInGB, StorageIOps

Set-AzSqlInstance -Name "managedinstance1" -ResourceGroupName "ResourceGroup01" -Edition "GeneralPurpose" -ComputeGeneration "Gen5" -IsGeneralPurposeV2 $true -VCore 8 -StorageSizeInGB 1024 -StorageIOps 4000

Location                 : westcentralus
Id                       : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName        : resourcegroup01
ManagedInstanceName      : managedInstance1
Tags                     :
Identity                 : Microsoft.Azure.Management.Sql.Models.ResourceIdentity
Sku                      : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2       : true
FullyQualifiedDomainName : managedInstance1.wcusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin       : adminLogin1
AdministratorPassword    :
SubnetId                 : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
LicenseType              : LicenseIncluded
VCores                   : 8
MemorySizeInGB           :
StorageSizeInGB          : 1024
StorageIOps              : 4000
InstancePoolName         :

Cette commande modifie l’instance existante en GPv2 en définissant de nouvelles valeurs pour -Edition, -ComputeGeneration, -IsGeneralPurposeV2. Définit également de nouvelles valeurs pour -VCore, StorageSizeInGB, StorageIOps

Exemple 4 : Définir une instance existante à l’aide de nouvelles valeurs pour -AdministratorPassword, -LicenseType, -StorageSizeInGB et -VCore pour une instance au sein d’un pool d’instances

$SecureString = ConvertTo-SecureString -String "****" -AsPlainText -Force
Set-AzSqlInstance -Name "managedinstance1" -ResourceGroupName "ResourceGroup01" -AdministratorPassword $SecureString -LicenseType LicenseIncluded -StorageSizeInGB 1024 -VCore 2 -InstancePoolName instancePool0

Location                 : westcentralus
Id                       : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName        : resourcegroup01
ManagedInstanceName      : managedInstance1
Tags                     :
Identity                 : Microsoft.Azure.Management.Sql.Models.ResourceIdentity
Sku                      : Microsoft.Azure.Management.Internal.Resources.Models.Sku
FullyQualifiedDomainName : managedInstance1.wcusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin       : adminLogin1
AdministratorPassword    :
SubnetId                 : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
LicenseType              : LicenseIncluded
VCores                   : 2
StorageSizeInGB          : 1024
InstancePoolName         : instancePool0

Cette commande définit une instance existante à l’aide de nouvelles valeurs pour -AdministratorPassword, -LicenseType, -StorageSizeInGB et -VCore pour une instance au sein d’un pool d’instances

Exemple 5 : Mettre à jour la configuration de maintenance pour une instance existante

Set-AzSqlInstance -Name "managedInstance1" -ResourceGroupName "resourcegroup01" -MaintenanceConfigurationId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_WestUS_MI_2"

Location                   : westus
Id                         : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName          : resourcegroup01
ManagedInstanceName        : managedInstance1
Tags                       :
Identity                   :
Sku                        : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2         :
FullyQualifiedDomainName   : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin         : adminLogin1
AdministratorPassword      :
SubnetId                   : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
LicenseType                : LicenseIncluded
VCores                     : 8
MemorySizeInGB             :
StorageSizeInGB            : 256
StorageIOps                :
Collation                  : SQL_Latin1_General_CP1_CI_AS
PublicDataEndpointEnabled  : False
ProxyOverride              :
TimezoneId                 : UTC
DnsZonePartner             :
DnsZone                    : ad35cna0mw
InstancePoolName           :
MinimalTlsVersion          :
BackupStorageRedundancy    : Geo
CurrentBackupStorageRedundancy    : Geo
MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_WestUS_MI_2

Cette commande met à jour l’instance existante avec la configuration de maintenance MI_2

Exemple 6 : Supprimer la configuration de maintenance de l’instance existante

Set-AzSqlInstance -Name "managediInstance1" -ResourceGroupName "Resourcegroup01" -MaintenanceConfigurationId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"

Location                   : westus
Id                         : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName          : resourcegroup01
ManagedInstanceName        : managedInstance1
Tags                       :
Identity                   :
Sku                        : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2         :
FullyQualifiedDomainName   : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin         : adminLogin1
AdministratorPassword      :
SubnetId                   : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
LicenseType                : LicenseIncluded
VCores                     : 8
MemorySizeInGB             :
StorageSizeInGB            : 256
StorageIOps                :
Collation                  : SQL_Latin1_General_CP1_CI_AS
PublicDataEndpointEnabled  : False
ProxyOverride              :
TimezoneId                 : UTC
DnsZonePartner             :
DnsZone                    : ad35cna0mw
InstancePoolName           :
MinimalTlsVersion          :
BackupStorageRedundancy    : Geo
CurrentBackupStorageRedundancy    : Geo
MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default

Cette commande réinitialise la configuration de maintenance par défaut pour l’instance existante

Exemple 7 : Déplacer une instance managée vers un autre sous-réseau

Set-AzSqlInstance -Name "managediInstance1" -ResourceGroupName "Resourcegroup01" -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/target_subnet_name"

Location                   : westus
Id                         : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName          : resourcegroup01
ManagedInstanceName        : managedInstance1
Tags                       :
Identity                   :
Sku                        : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2         :
FullyQualifiedDomainName   : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin         : adminLogin1
AdministratorPassword      :
SubnetId                   : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/target_subnet_name
LicenseType                : LicenseIncluded
VCores                     : 8
MemorySizeInGB             :
StorageSizeInGB            : 256
StorageIOps                :
Collation                  : SQL_Latin1_General_CP1_CI_AS
PublicDataEndpointEnabled  : False
ProxyOverride              :
TimezoneId                 : UTC
DnsZonePartner             :
DnsZone                    : ad35cna0mw
InstancePoolName           :
MinimalTlsVersion          :
BackupStorageRedundancy    : Geo
CurrentBackupStorageRedundancy    : Geo
MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default

Cette commande déplace l’instance managée vers un autre sous-réseau

Exemple 8 : Mettre à jour une instance existante pour qu’elle soit redondante

Set-AzSqlInstance -Name "managediInstance1" -ResourceGroupName "Resourcegroup01" -ZoneRedundant

Location                   : westus
Id                         : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName          : resourcegroup01
ManagedInstanceName        : managedInstance1
Tags                       :
Identity                   :
Sku                        : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2         :
FullyQualifiedDomainName   : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin         : adminLogin1
AdministratorPassword      :
SubnetId                   : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/target_subnet_name
LicenseType                : LicenseIncluded
VCores                     : 8
MemorySizeInGB             :
StorageSizeInGB            : 256
StorageIOps                :
Collation                  : SQL_Latin1_General_CP1_CI_AS
PublicDataEndpointEnabled  : False
ProxyOverride              :
TimezoneId                 : UTC
DnsZonePartner             :
DnsZone                    : ad35cna0mw
InstancePoolName           :
MinimalTlsVersion          :
BackupStorageRedundancy    : Geo
CurrentBackupStorageRedundancy    : Geo
MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default
ZoneRedundant              : true

Cette commande met à jour une instance existante pour qu’elle soit redondante interzone.

Exemple 9 : Mettre à jour la redondance du stockage de sauvegarde sur une instance existante

Set-AzSqlInstance -Name "managediInstance1" -ResourceGroupName "Resourcegroup01" -BackupStorageRedundancy Local -Force

Location                         : westus
Id                               : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName                : resourcegroup01
ManagedInstanceName              : managedInstance1
Tags                             :
Identity                         :
Sku                              : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2               :
FullyQualifiedDomainName         : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin               : adminLogin1
AdministratorPassword            :
SubnetId                         : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/target_subnet_name
LicenseType                      : LicenseIncluded
VCores                           : 8
MemorySizeInGB             :
StorageSizeInGB                  : 256
StorageIOps                      :
Collation                        : SQL_Latin1_General_CP1_CI_AS
PublicDataEndpointEnabled        : False
ProxyOverride                    :
TimezoneId                       : UTC
DnsZonePartner                   :
DnsZone                          : ad35cna0mw
InstancePoolName                 :
MinimalTlsVersion                :
BackupStorageRedundancy          : Geo
CurrentBackupStorageRedundancy   : Geo
RequestedBackupStorageRedundancy : Local
MaintenanceConfigurationId       : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default
ZoneRedundant                    : False

Cette commande modifie le type de redondance de stockage pour l’instance managée

Exemple 10 : Mettre à jour une instance existante avec le format de base de données et le modèle tarifaire

Set-AzSqlInstance -Name "managediInstance1" -ResourceGroupName "Resourcegroup01" -DatabaseFormat AlwaysUpToDate -PricingModel Regular

Location                   : westus
Id                         : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName          : resourcegroup01
ManagedInstanceName        : managedInstance1
Tags                       :
Identity                   :
Sku                        : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2         :
FullyQualifiedDomainName   : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin         : adminLogin1
AdministratorPassword      :
SubnetId                   : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/target_subnet_name
LicenseType                : LicenseIncluded
VCores                     : 8
MemorySizeInGB             :
StorageSizeInGB            : 256
StorageIOps                :
Collation                  : SQL_Latin1_General_CP1_CI_AS
PublicDataEndpointEnabled  : False
ProxyOverride              :
TimezoneId                 : UTC
DnsZonePartner             :
DnsZone                    : ad35cna0mw
InstancePoolName           :
MinimalTlsVersion          :
BackupStorageRedundancy    : Geo
CurrentBackupStorageRedundancy    : Geo
MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default
ZoneRedundant              : true
DatabaseFormat             : AlwaysUpToDate
PricingModel               : Regular

Cette commande met à jour l’instance managée avec le format de base de données et le modèle tarifaire spécifiés.

Exemple 11 : Mettre à jour une instance managée existante pour utiliser le mode de métadonnées d’authentification Windows

Set-AzSqlInstance -Name managedInstance1 -ResourceGroupName ResourceGroup01 -AuthenticationMetadata Windows

Location                         : westcentralus
Id                               : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName                : resourcegroup01
ManagedInstanceName              : managedInstance1
Tags                             :
Identity                         :
Sku                              : Microsoft.Azure.Management.Internal.Resources.Models.Sku
FullyQualifiedDomainName         : managedInstance1.xxxxxxxxxxxx.database.windows.net
AdministratorLogin               : adminLogin1
AdministratorPassword            :
SubnetId                         : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
LicenseType                      : LicenseIncluded
VCores                           : 8
MemorySizeInGB                   :
StorageSizeInGB                  : 256
Collation                        : SQL_Latin1_General_CP1_CI_AS
PublicDataEndpointEnabled        : False
ProxyOverride                    : Proxy
TimezoneId                       : UTC
DnsZonePartner                   :
DnsZone                          : ad35cna0mw
InstancePoolName                 :
MinimalTlsVersion                :
BackupStorageRedundancy          : Geo
RequestedBackupStorageRedundancy : Geo
CurrentBackupStorageRedundancy   : Geo
MaintenanceConfigurationId       : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default
Administrators                   :
PrimaryUserAssignedIdentityId    :
KeyId                            :
ZoneRedundant                    : False
ServicePrincipal                 :
DatabaseFormat                   : SQLServer2022
PricingModel                     : Regular
ExternalGovernanceStatus         : Disabled
AuthenticationMetadata           : Windows

Cette commande met à jour une instance managée existante pour utiliser les métadonnées Windows pour l’authentification des utilisateurs synchronisés.

Exemple 12 : Modifier l’instance existante en définissant une nouvelle valeur sur MemorySizeInGB et en conservant la valeur actuelle ou la définition de la nouvelle valeur pour les VCores et en conservant l’édition NextGen GP (v2)

Set-AzSqlInstance -Name "managedinstance1" -ResourceGroupName "ResourceGroup01" -MemorySizeInGB 64 -VCore 8 -IsGeneralPurposeV2 $true

Location                 : westcentralus
Id                       : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
ResourceGroupName        : resourcegroup01
ManagedInstanceName      : managedInstance1
Tags                     :
Identity                 : Microsoft.Azure.Management.Sql.Models.ResourceIdentity
Sku                      : Microsoft.Azure.Management.Internal.Resources.Models.Sku
IsGeneralPurposeV2       : true
FullyQualifiedDomainName : managedInstance1.wcusxxxxxxxxxxxxx.database.windows.net
AdministratorLogin       : adminLogin1
AdministratorPassword    :
SubnetId                 : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
LicenseType              : LicenseIncluded
VCores                   : 8
MemorySizeInGB           : 64
StorageSizeInGB          : 1024
StorageIOps              : 4000
InstancePoolName         :

Paramètres

-AdministratorPassword

Nouveau mot de passe administrateur SQL pour l’instance.

Propriétés du paramètre

Type:	SecureString
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AsJob

Exécuter l’applet de commande en arrière-plan

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AssignIdentity

Générez et affectez une identité Microsoft Entra pour cette instance à utiliser avec des services de gestion de clés comme Azure KeyVault.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AuthenticationMetadata

Métadonnées préférées à utiliser pour l’authentification des utilisateurs locaux synchronisés. La valeur par défaut est AzureAD.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	AzureAD, Paired, Windows
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-BackupStorageRedundancy

Redondance du stockage de sauvegarde utilisée pour stocker les sauvegardes pour Sql Azure Managed Instance. Les options sont les suivantes : Local, Zone et Geo

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	Local, Zone, Geo, GeoZone
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ComputeGeneration

Génération de calcul pour l’instance.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DatabaseFormat

Format de base de données de l’instance. Les valeurs possibles sont les suivantes :

AlwaysUpToDate : l’instance accède à toutes les nouvelles fonctionnalités du moteur SQL dès qu’elles sont publiées dans Azure. Le format de base de données évolue pour prendre en charge les nouvelles fonctionnalités.
SQLServer2022 : l’instance continue d’obtenir des correctifs de bogues du moteur SQL, des correctifs de sécurité et de petites améliorations fonctionnelles via les mises à jour cumulatives pour SQL Server 2022 pendant sa période de prise en charge standard. Le format de base de données reste compatible avec SQL Server 2022 pendant cette période.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

NewByEditionAndComputeGenerationParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DefaultProfile

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

Propriétés du paramètre

Type:	IAzureContextContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Edition

Édition à affecter à l’instance.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Force

Ignorer le message de confirmation pour l’exécution de l’action

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-IdentityType

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-InputObject

Objet AzureSqlManagedInstanceModel à supprimer

Propriétés du paramètre

Type:	AzureSqlManagedInstanceModel
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	SqlInstance

Jeux de paramètres

SetInstanceFromAzureSqlManagedInstanceModelInstanceDefinition

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-InstancePoolName

Nom du pool d’instances.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-IsGeneralPurposeV2

Indique s’il s’agit d’une variante GPv2 de l’édition Usage général.

Propriétés du paramètre

Type:	Nullable<T>[Boolean]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-KeyId

URI Azure Key Vault utilisé pour le chiffrement.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-LicenseType

Détermine le type de licence à utiliser. Les valeurs possibles sont les suivantes :

BasePrice - Le tarif réduit Azure Hybrid Benefit (AHB) pour les propriétaires de licences SQL Server existants est appliqué. Le prix du service Managed Instance sera réduit pour les propriétaires de licences SQL Server existants.
LicenseIncluded - La tarification de remise Azure Hybrid Benefit (AHB) pour les propriétaires de licences SQL Server existants n’est pas appliquée. Le prix du service Managed Instance inclut un nouveau coût de licence SQL Server.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MaintenanceConfigurationId

ID de configuration de maintenance pour Sql Azure Managed Instance.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MemorySizeInGB

Détermine la quantité de mémoire en Go à associer à l’instance

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-MinimalTlsVersion

Version TLS minimale à appliquer pour Managed Instance

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	None, 1.0, 1.1, 1.2
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Nom de l’instance.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Nom de l'instance

Jeux de paramètres

SetInstanceFromInputParameters

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-PricingModel

Modèle de tarification de l’instance.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

NewByEditionAndComputeGenerationParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-PrimaryUserAssignedIdentityId

ID UMI (User Managed Identity) principal.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ProxyOverride

Type de connexion utilisé pour la connexion à l’instance.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-PublicDataEndpointEnabled

Indique si le point de terminaison de données public est activé ou non pour l’instance.

Propriétés du paramètre

Type:	Nullable<T>[Boolean]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

SetInstanceFromInputParameters

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ResourceId

ID de ressource de l’instance à supprimer

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

SetInstanceFromAzureResourceId

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-ServicePrincipalType

Type de principal de service à utiliser. Les valeurs possibles sont SystemAssigned et None.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Valeurs acceptées:	None, SystemAssigned
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StorageIOps

Détermine la quantité d’IOps de stockage à associer à l’instance

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-StorageSizeInGB

Détermine la taille de stockage à associer à l’instance

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-SubnetId

ID de sous-réseau à utiliser pour la mise à jour d’instance.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Tag

Balises à associer à l’instance.

Propriétés du paramètre

Type:	Hashtable
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Étiquettes

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-UserAssignedIdentityId

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

Propriétés du paramètre

Type:	List<T>[String]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-VCore

Détermine la quantité de VCore à associer à l’instance

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ZoneRedundant

Utiliser un stockage redondant interzone

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Partager via

Set-AzSqlInstance

Syntaxe

SetInstanceFromInputParameters (Par défaut)

SetInstanceFromAzureSqlManagedInstanceModelInstanceDefinition

SetInstanceFromAzureResourceId

Description

Exemples

Exemple 1 : Définir une instance existante à l’aide de nouvelles valeurs pour -AdministratorPassword, -LicenseType, -StorageSizeInGB, -VCore et -Edition

Exemple 2 : Modifier la génération de matériel d’instance existante à l’aide de la nouvelle valeur pour -ComputeGeneration

Exemple 3 : Remplacez l’instance existante par GPv2 en définissant de nouvelles valeurs pour -Edition, -ComputeGeneration, -IsGeneralPurposeV2. Définissez également de nouvelles valeurs pour -VCore, StorageSizeInGB, StorageIOps

Exemple 4 : Définir une instance existante à l’aide de nouvelles valeurs pour -AdministratorPassword, -LicenseType, -StorageSizeInGB et -VCore pour une instance au sein d’un pool d’instances

Exemple 5 : Mettre à jour la configuration de maintenance pour une instance existante

Exemple 6 : Supprimer la configuration de maintenance de l’instance existante

Exemple 7 : Déplacer une instance managée vers un autre sous-réseau

Exemple 8 : Mettre à jour une instance existante pour qu’elle soit redondante

Exemple 9 : Mettre à jour la redondance du stockage de sauvegarde sur une instance existante

Exemple 10 : Mettre à jour une instance existante avec le format de base de données et le modèle tarifaire

Exemple 11 : Mettre à jour une instance managée existante pour utiliser le mode de métadonnées d’authentification Windows

Exemple 12 : Modifier l’instance existante en définissant une nouvelle valeur sur MemorySizeInGB et en conservant la valeur actuelle ou la définition de la nouvelle valeur pour les VCores et en conservant l’édition NextGen GP (v2)

Paramètres

-AdministratorPassword

Propriétés du paramètre

Jeux de paramètres

-AsJob

Propriétés du paramètre

Jeux de paramètres

-AssignIdentity

Propriétés du paramètre

Jeux de paramètres

-AuthenticationMetadata

Propriétés du paramètre

Jeux de paramètres

-BackupStorageRedundancy

Propriétés du paramètre

Jeux de paramètres

-ComputeGeneration

Propriétés du paramètre

Jeux de paramètres

-Confirm

Propriétés du paramètre

Jeux de paramètres

-DatabaseFormat

Propriétés du paramètre

Jeux de paramètres

-DefaultProfile

Propriétés du paramètre

Jeux de paramètres

-Edition

Propriétés du paramètre

Jeux de paramètres

-Force

Propriétés du paramètre

Jeux de paramètres

-IdentityType

Propriétés du paramètre

Jeux de paramètres

-InputObject

Propriétés du paramètre

Jeux de paramètres

-InstancePoolName

Propriétés du paramètre

Jeux de paramètres

-IsGeneralPurposeV2

Propriétés du paramètre

Jeux de paramètres

-KeyId

Propriétés du paramètre

Jeux de paramètres

-LicenseType

Propriétés du paramètre

Jeux de paramètres

-MaintenanceConfigurationId

Propriétés du paramètre

Jeux de paramètres

-MemorySizeInGB

Propriétés du paramètre

Jeux de paramètres

-MinimalTlsVersion

Propriétés du paramètre