< Back

Get-AzureRmVMSqlServerExtension

Tue Jan 29, 2019 9:38 pm

NAME Get-AzureRmVMSqlServerExtension



SYNOPSIS

Gets the settings for a SQL Server extension on a virtual machine.





SYNTAX

Get-AzureRmVMSqlServerExtension [-ResourceGroupName] <String> [-VMName] <String> [[-Name] <String>] [-DefaultProfile <IAzureContextContainer>]

[<CommonParameters>]





DESCRIPTION

The Get-AzureRmVMSqlServerExtension cmdlet gets the settings of the SQL Server infrastructure as a service (IaaS) Agent on a virtual machine.





PARAMETERS

-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Specifies the name of the SQL Server the extension.



Required? false

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ResourceGroupName <String>

Specifies the name of the resource group of the virtual machine.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-VMName <String>

Specifies the name of the virtual machine.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

This cmdlet does not accept any input.





OUTPUTS

Microsoft.Azure.Commands.Compute.VirtualMachineSqlServerExtensionContext







NOTES









Example 1: Get the settings of a SQL Server extension on a virtual machine



PS C:\\> Get-AzureRmVMSqlServerExtension -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"

ExtensionName : SqlIaaSAgent

Publisher : Microsoft.SqlServer.Management

Version : 1.0

State : Enable

RoleName : VMName

AutoPatchingSettings : Microsoft.WindowsAzure.Commands.ServiceManagement.IaaS.Extensions.AutoPatchingSettings

AutoBackupSettings : Microsoft.WindowsAzure.Commands.ServiceManagement.IaaS.Extensions.AutoBackupSettings



This command gets the settings of the SQL Server extension on a virtual machine named ContosoVM07.





Example 2: Get the settings by using the pipeline



PS C:\\> Get-AzureRmVM -ServiceName "Service08" -Name "ContosoVM22" | Get-AzureRmVMSqlServerExtension

ExtensionName : SqlIaaSAgent

Publisher : Microsoft.SqlServer.Management

Version : 1.0

State : Enable

RoleName : VMName

AutoPatchingSettings : Microsoft.WindowsAzure.Commands.ServiceManagement.IaaS.Extensions.AutoPatchingSettings

AutoBackupSettings : Microsoft.WindowsAzure.Commands.ServiceManagement.IaaS.Extensions.AutoBackupSettings



This command gets the virtual machine named ContosoVM22 on the service Service08 by using the Get-AzureRmVM cmdlet. The command passes the results

to the current cmdlet by using the pipeline operator.



The current command gets the settings of the SQL Server IaaS Agent on that virtual machine.





Example 3: Get the settings of specific SQL Server version



PS C:\\> Get-AzureRmVMSqlServerExtension -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07" -Version "1.0"

ExtensionName : SqlIaaSAgent

Publisher : Microsoft.SqlServer.Management

Version : 1.0

State : Enable

RoleName : VMName

AutoPatchingSettings : Microsoft.WindowsAzure.Commands.ServiceManagement.IaaS.Extensions.AutoPatchingSettings

AutoBackupSettings : Microsoft.WindowsAzure.Commands.ServiceManagement.IaaS.Extensions.AutoBackupSettings



This command gets the settings of version 1.0 of the SQL Server extension on a virtual machine named ContosoVM07.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... rextension

Get-AzureRmVmssDiskEncryption

Remove-AzureRmVMSqlServerExtension

Set-AzureRmVMSqlServerExtension