Get-AzSqlInstancePoolUsage
Returns information about an Azure SQL Instance pool's usage.
Syntax
Get-AzSqlInstancePoolUsage
[-ResourceGroupName] <String>
[-Name] <String>
[-ExpandChildren]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzSqlInstancePoolUsage
[-InstancePool] <AzureSqlInstancePoolModel>
[-ExpandChildren]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzSqlInstancePoolUsage
[-ResourceId] <String>
[-ExpandChildren]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
The Get-AzSqlInstancePoolUsage cmdlet returns information an Azure SQL Instance pool's usage.
Examples
Example 1 : Gets the usage of an Azure SQL Instance pool
Get-AzSqlInstancePoolUsage -ResourceGroupName resourcegroup01 -Name instancepool0
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/vcore_utilization
CurrentValue : 2
Limit : 8
RequestedLimit :
Unit : VCores
Name : VCore utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/storage_utilization
CurrentValue : 32
Limit : 8192
RequestedLimit :
Unit : Gigabytes
Name : Storage utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/database_utilization
CurrentValue : 0
Limit : 100
RequestedLimit :
Unit : Number Of Databases
Name : Database utilization
Type : Microsoft.Sql/instancePools/usages
Gets the usage for the Azure SQL Instance pool instancepool0.
Example 2: Gets the usage of an Azure SQL Instance pool using an instance pool object
$instancePool = Get-AzSqlInstancePool -ResourceGroupName resourcegroup01 -Name instancepool0
Get-AzSqlInstancePoolUsage -InstancePool $instancePool
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/vcore_utilization
CurrentValue : 2
Limit : 8
RequestedLimit :
Unit : VCores
Name : VCore utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/storage_utilization
CurrentValue : 32
Limit : 8192
RequestedLimit :
Unit : Gigabytes
Name : Storage utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/database_utilization
CurrentValue : 0
Limit : 100
RequestedLimit :
Unit : Number Of Databases
Name : Database utilization
Type : Microsoft.Sql/instancePools/usages
Gets the usage for the Azure SQL Instance pool instancepool0 using an instance pool object.
Example 3: Gets the usage of an Azure SQL Instance pool using an instance pool resource id
Get-AzSqlInstancePoolUsage -ResourceId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancePool0"
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/vcore_utilization
CurrentValue : 2
Limit : 8
RequestedLimit :
Unit : VCores
Name : VCore utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/storage_utilization
CurrentValue : 32
Limit : 8192
RequestedLimit :
Unit : Gigabytes
Name : Storage utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/database_utilization
CurrentValue : 0
Limit : 100
RequestedLimit :
Unit : Number Of Databases
Name : Database utilization
Type : Microsoft.Sql/instancePools/usages
Gets the usage for the Azure SQL Instance pool instancepool0 using an instance pool resource identifier.
Example 3: Gets the usage of an Azure SQL Instance pool with a breakdown of the managed instance usages within the pool.
Get-AzSqlInstancePoolUsage -ResourceGroupName resourcegroup01 -Name instancepool0 -ExpandChildren
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/vcore_utilization
CurrentValue : 2
Limit : 8
RequestedLimit :
Unit : VCores
Name : VCore utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/storage_utilization
CurrentValue : 32
Limit : 8192
RequestedLimit :
Unit : Gigabytes
Name : Storage utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourcegroup01/providers/Microsoft.Sql/instancePools/instancepool0/usages/database_utilization
CurrentValue : 0
Limit : 100
RequestedLimit :
Unit : Number Of Databases
Name : Database utilization
Type : Microsoft.Sql/instancePools/usages
Id : /subscriptions/2e7fe4bd-90c7-454e-8bb6-dc44649f27b2/resourceGroups/poolsPS/providers/Microsoft.Sql/instancePools/instancepool0/managedInstances/managedinstance0/usages/vcore_utilization
CurrentValue :
Limit : 2
RequestedLimit :
Unit : VCores
Name : VCore utilization
Type : Microsoft.Sql/instancePools/managedInstances/usages
Id : /subscriptions/2e7fe4bd-90c7-454e-8bb6-dc44649f27b2/resourceGroups/poolsPS/providers/Microsoft.Sql/instancePools/instancepool0/managedInstances/managedinstance0/usages/storage_utilization
CurrentValue :
Limit : 32
RequestedLimit :
Unit : Gigabytes
Name : Storage utilization
Type : Microsoft.Sql/instancePools/managedInstances/usages
Id : /subscriptions/2e7fe4bd-90c7-454e-8bb6-dc44649f27b2/resourceGroups/poolsPS/providers/Microsoft.Sql/instancePools/instancepool0/managedInstances/managedinstance0/usages/database_utilization
CurrentValue : 0
Limit : 100
RequestedLimit :
Unit : Number Of Databases
Name : Database utilization
Type : Microsoft.Sql/instancePools/managedInstances/usages
Gets the usage for the Azure SQL Instance pool instancepool0 along with the usages of the managed instances within instancepool0.
Parameters
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpandChildren
Flag indicating whether to expand this instance pool's usage with its children's usage.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstancePool
The parent instance pool object.
Type: | AzureSqlInstancePoolModel |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
The managed instance pool name.
Type: | String |
Aliases: | InstancePoolName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
The resource group name.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
The parent resource id.
Type: | String |
Aliases: | InstancePoolResourceId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Inputs
Outputs
Azure PowerShell