Compartir a través de

Set-AzSqlInstanceDtc

  • Referencia
Módulo:
Az.Sql

Establece las propiedades de una instancia de Azure SQL Instancia administrada DTC

Sintaxis

Set-AzSqlInstanceDtc
   [-ResourceGroupName] <String>
   [-InstanceName] <String>
   [[-DtcEnabled] <Boolean>]
   [[-ExternalDnsSuffixSearchList] <System.Collections.Generic.List`1[System.String]>]
   [-XaTransactionsEnabled <Boolean>]
   [-SnaLu6point2TransactionsEnabled <Boolean>]
   [-XaTransactionsDefaultTimeout <Int32>]
   [-XaTransactionsMaximumTimeout <Int32>]
   [-AllowInboundEnabled <Boolean>]
   [-AllowOutboundEnabled <Boolean>]
   [-Authentication <String>]
   [-AsJob]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceDtc
   [-InstanceObject] <AzureSqlManagedInstanceModel>
   [[-DtcEnabled] <Boolean>]
   [[-ExternalDnsSuffixSearchList] <System.Collections.Generic.List`1[System.String]>]
   [-XaTransactionsEnabled <Boolean>]
   [-SnaLu6point2TransactionsEnabled <Boolean>]
   [-XaTransactionsDefaultTimeout <Int32>]
   [-XaTransactionsMaximumTimeout <Int32>]
   [-AllowInboundEnabled <Boolean>]
   [-AllowOutboundEnabled <Boolean>]
   [-Authentication <String>]
   [-AsJob]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceDtc
   [-InputObject] <AzureSqlManagedInstanceDtcModel>
   [[-DtcEnabled] <Boolean>]
   [[-ExternalDnsSuffixSearchList] <System.Collections.Generic.List`1[System.String]>]
   [-XaTransactionsEnabled <Boolean>]
   [-SnaLu6point2TransactionsEnabled <Boolean>]
   [-XaTransactionsDefaultTimeout <Int32>]
   [-XaTransactionsMaximumTimeout <Int32>]
   [-AllowInboundEnabled <Boolean>]
   [-AllowOutboundEnabled <Boolean>]
   [-Authentication <String>]
   [-AsJob]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceDtc
   [-ResourceId] <String>
   [[-DtcEnabled] <Boolean>]
   [[-ExternalDnsSuffixSearchList] <System.Collections.Generic.List`1[System.String]>]
   [-XaTransactionsEnabled <Boolean>]
   [-SnaLu6point2TransactionsEnabled <Boolean>]
   [-XaTransactionsDefaultTimeout <Int32>]
   [-XaTransactionsMaximumTimeout <Int32>]
   [-AllowInboundEnabled <Boolean>]
   [-AllowOutboundEnabled <Boolean>]
   [-Authentication <String>]
   [-AsJob]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzSqlInstanceDtc modifica las propiedades de una instancia administrada de Azure SQL DTC.

Ejemplos

Ejemplo 1 Habilitación de DTC para una instancia administrada

Set-AzSqlInstanceDtc -ResourceGroupName ResourceGroup1 -InstanceName ManagedInstance1 -DtcEnabled $true

ResourceGroupName           : ResourceGroup1
ManagedInstanceName         : ManagedInstance1
Id                          : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Sql/managedInstances/ManagedInstance1/dtc/current
DtcEnabled                  : True
DtcHostNameDnsSuffix        : suffix1.net
DtcHostName                 : name1.suffix1.net
ExternalDnsSuffixSearchList : {suffix1.net}
SecuritySettings            : Microsoft.Azure.Management.Sql.Models.ManagedInstanceDtcSecuritySettings

Este comando habilita DTC de instancia administrada para la instancia administrada ManagedInstance1.

Ejemplo 2 Habilitación de transacciones XA para DTC

$dtc = Set-AzSqlInstanceDtc -ResourceGroupName ResourceGroup1 -InstanceName ManagedInstance1 -XaTransactionsEnabled $true
Write-Output $dtc.SecuritySettings

TransactionManagerCommunicationSettings : Microsoft.Azure.Management.Sql.Models.ManagedInstanceDtcTransactionManagerCommunicationSettings
XaTransactionsEnabled                   : True
SnaLu6point2TransactionsEnabled         : True
XaTransactionsDefaultTimeout            : 0
XaTransactionsMaximumTimeout            : 0

Este comando habilita las transacciones XA para DTC de instancia administrada.

Ejemplo 3 Habilitación de DTC para una instancia administrada capturada previamente

$managedInstance = Get-AzSqlInstance -ResourceGroupName ResourceGroup1 -InstanceName ManagedInstance1
Set-AzSqlInstanceDtc -InstanceObject $managedInstance

ResourceGroupName           : ResourceGroup1
ManagedInstanceName         : ManagedInstance1
Id                          : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Sql/managedInstances/ManagedInstance1/dtc/current
DtcEnabled                  : True
DtcHostNameDnsSuffix        : suffix1.net
DtcHostName                 : name1.suffix1.net
ExternalDnsSuffixSearchList : {suffix1.net}
SecuritySettings            : Microsoft.Azure.Management.Sql.Models.ManagedInstanceDtcSecuritySettings

Este comando habilita DTC de instancia administrada pasando el objeto de instancia administrada.

Ejemplo 4 Habilitación de transacciones XA para un objeto DTC capturado previamente

$dtc = Get-AzSqlInstanceDtc -ResourceGroupName ResourceGroup1 -InstanceName ManagedInstance1
$dtc = Set-AzSqlInstanceDtc -InputObject $dtc -DtcEnabled $true
Write-Output $dtc.SecuritySettings

TransactionManagerCommunicationSettings : Microsoft.Azure.Management.Sql.Models.ManagedInstanceDtcTransactionManagerCommunicationSettings
XaTransactionsEnabled                   : True
SnaLu6point2TransactionsEnabled         : True
XaTransactionsDefaultTimeout            : 0
XaTransactionsMaximumTimeout            : 0

Este comando habilita las transacciones XA para DTC pasando el objeto DTC.

Ejemplo 5 Habilitar DTC con un identificador de recurso específico

Set-AzSqlInstanceDtc -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Sql/managedInstances/ManagedInstance1/dtc/current -DtcEnabled $true

ResourceGroupName           : ResourceGroup1
ManagedInstanceName         : ManagedInstance1
Id                          : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Sql/managedInstances/ManagedInstance1/dtc/current
DtcEnabled                  : True
DtcHostNameDnsSuffix        : suffix1.net
DtcHostName                 : name1.suffix1.net
ExternalDnsSuffixSearchList : {suffix1.net}
SecuritySettings            : Microsoft.Azure.Management.Sql.Models.ManagedInstanceDtcSecuritySettings

Este comando habilita DTC de instancia administrada pasando el identificador de recurso de DTC.

Parámetros

-AllowInboundEnabled

Habilite el tráfico entrante.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllowOutboundEnabled

Habilite el tráfico saliente.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsJob

Ejecute el cmdlet en segundo plano.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Authentication

Tipo de autenticación

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DtcEnabled

Estado habilitado para DTC.

Tipo:Nullable<T>[Boolean]
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExternalDnsSuffixSearchList

Lista de búsqueda de sufijos DNS externo.

Tipo:List<T>[String]
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Omita el mensaje de confirmación para realizar la acción.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Objeto de entrada de la instancia administrada DTC.

Tipo:AzureSqlManagedInstanceDtcModel
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InstanceName

Nombre de la instancia administrada.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstanceObject

Objeto de entrada de la instancia administrada.

Tipo:AzureSqlManagedInstanceModel
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceId

Identificador de recurso de la instancia administrada DTC.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SnaLu6point2TransactionsEnabled

Estado habilitado para transacciones lu 6.2 de SNA.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-XaTransactionsDefaultTimeout

Tiempo de espera predeterminado de las transacciones XA.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-XaTransactionsEnabled

Estado habilitado para transacciones de XA.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-XaTransactionsMaximumTimeout

Tiempo de espera máximo de las transacciones de XA.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

AzureSqlManagedInstanceModel

AzureSqlManagedInstanceDtcModel

String

Salidas

AzureSqlManagedInstanceDtcModel