Skip to content

Commit 1959d3c

Browse files
kukislavVeryEarly
andauthored
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 <[email protected]>
1 parent a44c879 commit 1959d3c

File tree

2 files changed

+93
-0
lines changed

2 files changed

+93
-0
lines changed

src/Sql/Sql/help/New-AzSqlInstance.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -175,6 +175,37 @@ InstancePoolName : instancePool0
175175

176176
This command creates a new instance in an instance pool with name instancePool0
177177

178+
### Example 6: Create a new instance with maintenance configuration
179+
```powershell
180+
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"
181+
Location : westus
182+
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
183+
ResourceGroupName : resourcegroup01
184+
ManagedInstanceName : managedInstance1
185+
Tags :
186+
Identity :
187+
Sku : Microsoft.Azure.Management.Internal.Resources.Models.Sku
188+
FullyQualifiedDomainName : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
189+
AdministratorLogin : adminLogin1
190+
AdministratorPassword :
191+
SubnetId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
192+
LicenseType : LicenseIncluded
193+
VCores : 8
194+
StorageSizeInGB : 256
195+
Collation : SQL_Latin1_General_CP1_CI_AS
196+
PublicDataEndpointEnabled : False
197+
ProxyOverride :
198+
TimezoneId : UTC
199+
DnsZonePartner :
200+
DnsZone : ad35cna0mw
201+
InstancePoolName :
202+
MinimalTlsVersion :
203+
BackupStorageRedundancy : Geo
204+
MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_WestUS_MI_2
205+
```
206+
207+
This command creates a new instance with maintenance configuration MI_2
208+
178209
## PARAMETERS
179210

180211
### -AdministratorCredential

src/Sql/Sql/help/Set-AzSqlInstance.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,68 @@ InstancePoolName : instancePool0
114114

115115
This command sets existing instance using new values for -AdministratorPassword, -LicenseType, -StorageSizeInGB and -VCore for an instance within an instance pool
116116

117+
### Example 4: Update maintenance configuration for existing instance
118+
```powershell
119+
PS C:\> Set-AzSqlInstance -Name "managedInstance1" -ResourceGroupName "resourcegroup01" -MaintenanceConfigurationId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_WestUS_MI_2"
120+
Location : westus
121+
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
122+
ResourceGroupName : resourcegroup01
123+
ManagedInstanceName : managedInstance1
124+
Tags :
125+
Identity :
126+
Sku : Microsoft.Azure.Management.Internal.Resources.Models.Sku
127+
FullyQualifiedDomainName : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
128+
AdministratorLogin : adminLogin1
129+
AdministratorPassword :
130+
SubnetId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
131+
LicenseType : LicenseIncluded
132+
VCores : 8
133+
StorageSizeInGB : 256
134+
Collation : SQL_Latin1_General_CP1_CI_AS
135+
PublicDataEndpointEnabled : False
136+
ProxyOverride :
137+
TimezoneId : UTC
138+
DnsZonePartner :
139+
DnsZone : ad35cna0mw
140+
InstancePoolName :
141+
MinimalTlsVersion :
142+
BackupStorageRedundancy : Geo
143+
MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_WestUS_MI_2
144+
```
145+
146+
This command updates existing instance with maintenance configuration MI_2
147+
148+
### Example 5: Remove maintenance configuration from existing instance
149+
```powershell
150+
PS C:\> Set-AzSqlInstance -Name "managediInstance1" -ResourceGroupName "Resourcegroup01" -MaintenanceConfigurationId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
151+
Location : westus
152+
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/managedInstances/managedInstance1
153+
ResourceGroupName : resourcegroup01
154+
ManagedInstanceName : managedInstance1
155+
Tags :
156+
Identity :
157+
Sku : Microsoft.Azure.Management.Internal.Resources.Models.Sku
158+
FullyQualifiedDomainName : managedInstance1.wusxxxxxxxxxxxxx.database.windows.net
159+
AdministratorLogin : adminLogin1
160+
AdministratorPassword :
161+
SubnetId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name
162+
LicenseType : LicenseIncluded
163+
VCores : 8
164+
StorageSizeInGB : 256
165+
Collation : SQL_Latin1_General_CP1_CI_AS
166+
PublicDataEndpointEnabled : False
167+
ProxyOverride :
168+
TimezoneId : UTC
169+
DnsZonePartner :
170+
DnsZone : ad35cna0mw
171+
InstancePoolName :
172+
MinimalTlsVersion :
173+
BackupStorageRedundancy : Geo
174+
MaintenanceConfigurationId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default
175+
```
176+
177+
This command resets maintenance configuration to default for existing instance
178+
117179
## PARAMETERS
118180

119181
### -AdministratorPassword

0 commit comments

Comments
 (0)