From 0de85fb5ea51c414c1cf841aa67319de5e96397a Mon Sep 17 00:00:00 2001 From: Ivan Kulezic Date: Wed, 3 Feb 2021 19:36:55 +0100 Subject: [PATCH 1/4] Update create example --- src/Sql/Sql/help/New-AzSqlInstance.md | 31 +++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/src/Sql/Sql/help/New-AzSqlInstance.md b/src/Sql/Sql/help/New-AzSqlInstance.md index 1bbf08006f86..24a932974a5e 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 From 47acf708db241f6e88fdc2c0ad371050ec2253f3 Mon Sep 17 00:00:00 2001 From: Ivan Kulezic Date: Wed, 17 Feb 2021 17:36:41 +0100 Subject: [PATCH 2/4] Update examples for update MI scenario --- src/Sql/Sql/help/New-AzSqlInstance.md | 2 +- src/Sql/Sql/help/Set-AzSqlInstance.md | 62 +++++++++++++++++++++++++++ 2 files changed, 63 insertions(+), 1 deletion(-) diff --git a/src/Sql/Sql/help/New-AzSqlInstance.md b/src/Sql/Sql/help/New-AzSqlInstance.md index 24a932974a5e..b24f21482606 100644 --- a/src/Sql/Sql/help/New-AzSqlInstance.md +++ b/src/Sql/Sql/help/New-AzSqlInstance.md @@ -177,7 +177,7 @@ 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" +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 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 From c337418780d6a2679f46d162d9c86b5ea4e8045f Mon Sep 17 00:00:00 2001 From: Ivan Kulezic Date: Wed, 17 Feb 2021 17:49:42 +0100 Subject: [PATCH 3/4] Update changelog --- src/Sql/Sql/ChangeLog.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/Sql/Sql/ChangeLog.md b/src/Sql/Sql/ChangeLog.md index 1279ec84d69b..e2252cc274df 100644 --- a/src/Sql/Sql/ChangeLog.md +++ b/src/Sql/Sql/ChangeLog.md @@ -18,6 +18,7 @@ - Additional information about change #1 --> ## Upcoming Release +* Added examples for creating and updating managed instance with maintenance configuration ## Version 2.16.0 * Added MaintenanceConfigurationId to 'New-AzSqlDatabase', 'Set-AzSqlDatabase', 'New-AzSqlElasticPool' and 'Set-AzSqlElasticPool' From 1fd168aa36627d5f25563af4bb550e44a4b82ed4 Mon Sep 17 00:00:00 2001 From: Yabo Hu Date: Thu, 18 Feb 2021 15:34:07 +0800 Subject: [PATCH 4/4] Update ChangeLog.md --- src/Sql/Sql/ChangeLog.md | 1 - 1 file changed, 1 deletion(-) diff --git a/src/Sql/Sql/ChangeLog.md b/src/Sql/Sql/ChangeLog.md index e2252cc274df..1279ec84d69b 100644 --- a/src/Sql/Sql/ChangeLog.md +++ b/src/Sql/Sql/ChangeLog.md @@ -18,7 +18,6 @@ - Additional information about change #1 --> ## Upcoming Release -* Added examples for creating and updating managed instance with maintenance configuration ## Version 2.16.0 * Added MaintenanceConfigurationId to 'New-AzSqlDatabase', 'Set-AzSqlDatabase', 'New-AzSqlElasticPool' and 'Set-AzSqlElasticPool'