< Back
New-AzureRmSqlServerCommunicationLink
Post
NAME New-AzureRmSqlServerCommunicationLink
SYNOPSIS
Creates a communication link for elastic database transactions between two SQL Database servers.
SYNTAX
New-AzureRmSqlServerCommunicationLink [-ResourceGroupName] <String> [-ServerName] <String> [-AsJob] [-DefaultProfile <IAzureContextContainer>]
-LinkName <String> -PartnerServer <String> [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The New-AzureRmSqlServerCommunicationLink cmdlet creates a communication link for elastic database transactions between two logical servers in
Azure SQL Database. Elastic database transactions can span databases in either of the paired servers. You can create more than one link on a
server. Therefore, elastic database transactions can span across a larger number of servers.
PARAMETERS
-AsJob [<SwitchParameter>]
Run cmdlet in the background
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-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
-LinkName <String>
Specifies the name of the server communication link that this cmdlet creates.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PartnerServer <String>
Specifies the name of the other server that takes part in this communication link.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
Specifies the name of the resource group to which the server specified by the ServerName parameter belongs.
Required? true
Position? 0
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ServerName <String>
Specifies the name of the server on which this cmdlet sets up the communication link.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
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.Sql.Server.Model.AzureSqlServerCommunicationLinkModel
NOTES
* Keywords: azure, azurerm, arm, resource, management, manager, sql, database, mssql
Example 1: Create a communication link
PS C:\\>New-AzureRmSqlServerCommunicationLink -ResourceGroupName "ResourceGroup01" -ServerName "ContosoServer17" -LinkName "Link01" -PartnerServer
"ContosoServer02"
This command creates a link named Link01 between ContosoServer17 and ContosoServer02.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... cationlink
Get-AzureRmSqlServerCommunicationLink
Remove-AzureRmSqlServerCommunicationLink
SQL Database Documentation https://docs.microsoft.com/azure/sql-database/
SYNOPSIS
Creates a communication link for elastic database transactions between two SQL Database servers.
SYNTAX
New-AzureRmSqlServerCommunicationLink [-ResourceGroupName] <String> [-ServerName] <String> [-AsJob] [-DefaultProfile <IAzureContextContainer>]
-LinkName <String> -PartnerServer <String> [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The New-AzureRmSqlServerCommunicationLink cmdlet creates a communication link for elastic database transactions between two logical servers in
Azure SQL Database. Elastic database transactions can span databases in either of the paired servers. You can create more than one link on a
server. Therefore, elastic database transactions can span across a larger number of servers.
PARAMETERS
-AsJob [<SwitchParameter>]
Run cmdlet in the background
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-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
-LinkName <String>
Specifies the name of the server communication link that this cmdlet creates.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PartnerServer <String>
Specifies the name of the other server that takes part in this communication link.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
Specifies the name of the resource group to which the server specified by the ServerName parameter belongs.
Required? true
Position? 0
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ServerName <String>
Specifies the name of the server on which this cmdlet sets up the communication link.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
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.Sql.Server.Model.AzureSqlServerCommunicationLinkModel
NOTES
* Keywords: azure, azurerm, arm, resource, management, manager, sql, database, mssql
Example 1: Create a communication link
PS C:\\>New-AzureRmSqlServerCommunicationLink -ResourceGroupName "ResourceGroup01" -ServerName "ContosoServer17" -LinkName "Link01" -PartnerServer
"ContosoServer02"
This command creates a link named Link01 between ContosoServer17 and ContosoServer02.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... cationlink
Get-AzureRmSqlServerCommunicationLink
Remove-AzureRmSqlServerCommunicationLink
SQL Database Documentation https://docs.microsoft.com/azure/sql-database/