From 1959d3cfed5b4a6607f0d533148a7709ecdd7710 Mon Sep 17 00:00:00 2001 From: Ivan Kulezic <72797230+kukislav@users.noreply.github.com> Date: Fri, 19 Feb 2021 09:58:30 +0100 Subject: [PATCH] Add sql mi maintenance configuration examples (#14216) * Update create example * Update examples for update MI scenario * Update changelog * Update ChangeLog.md Co-authored-by: Yabo Hu --- src/Sql/Sql/help/New-AzSqlInstance.md | 31 ++++++++++++++ src/Sql/Sql/help/Set-AzSqlInstance.md | 62 +++++++++++++++++++++++++++ 2 files changed, 93 insertions(+) diff --git a/src/Sql/Sql/help/New-AzSqlInstance.md b/src/Sql/Sql/help/New-AzSqlInstance.md index 1bbf08006f86..b24f21482606 100644 --- a/src/Sql/Sql/help/New-AzSqlInstance.md +++ b/src/Sql/Sql/help/New-AzSqlInstance.md @@ -175,6 +175,37 @@ InstancePoolName : instancePool0 This command creates a new instance in an instance pool with name instancePool0 +### Example 6: Create a new instance with maintenance configuration +```powershell +PS C:\>New-AzSqlInstance -Name managedInstance1 -ResourceGroupName resourcegroup01 -Location "westus" -AdministratorCredential (Get-Credential) -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name" -VCore 8 -ComputeGeneration Gen5 -Edition GeneralPurpose -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 +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 +StorageSizeInGB : 256 +Collation : SQL_Latin1_General_CP1_CI_AS +PublicDataEndpointEnabled : False +ProxyOverride : +TimezoneId : UTC +DnsZonePartner : +DnsZone : ad35cna0mw +InstancePoolName : +MinimalTlsVersion : +BackupStorageRedundancy : Geo +MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_WestUS_MI_2 +``` + +This command creates a new instance with maintenance configuration MI_2 + ## PARAMETERS ### -AdministratorCredential diff --git a/src/Sql/Sql/help/Set-AzSqlInstance.md b/src/Sql/Sql/help/Set-AzSqlInstance.md index b30ed3d7dbb3..e01dfa50b581 100644 --- a/src/Sql/Sql/help/Set-AzSqlInstance.md +++ b/src/Sql/Sql/help/Set-AzSqlInstance.md @@ -114,6 +114,68 @@ InstancePoolName : instancePool0 This command sets existing instance using new values for -AdministratorPassword, -LicenseType, -StorageSizeInGB and -VCore for an instance within an instance pool +### Example 4: Update maintenance configuration for existing instance +```powershell +PS C:\> 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 +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 +StorageSizeInGB : 256 +Collation : SQL_Latin1_General_CP1_CI_AS +PublicDataEndpointEnabled : False +ProxyOverride : +TimezoneId : UTC +DnsZonePartner : +DnsZone : ad35cna0mw +InstancePoolName : +MinimalTlsVersion : +BackupStorageRedundancy : Geo +MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_WestUS_MI_2 +``` + +This command updates existing instance with maintenance configuration MI_2 + +### Example 5: Remove maintenance configuration from existing instance +```powershell +PS C:\> 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 +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 +StorageSizeInGB : 256 +Collation : SQL_Latin1_General_CP1_CI_AS +PublicDataEndpointEnabled : False +ProxyOverride : +TimezoneId : UTC +DnsZonePartner : +DnsZone : ad35cna0mw +InstancePoolName : +MinimalTlsVersion : +BackupStorageRedundancy : Geo +MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default +``` + +This command resets maintenance configuration to default for existing instance + ## PARAMETERS ### -AdministratorPassword