你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzSqlInstanceDtc

模块:: Az.Sql Module

设置 Azure SQL 托管实例 DTC 的属性

语法

SetByNameParameterSet （默认值）

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>]

SetByParentObjectParameterSet

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>]

SetByInputObjectParameterSet

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>]

SetByResourceIdParameterSet

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>]

说明

Set-AzSqlInstanceDtc cmdlet 修改 Azure SQL 托管实例 DTC 的属性。

示例

示例 1 为托管实例启用 DTC

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

此命令为托管实例 ManagedInstance1 启用托管实例 DTC。

示例 2 为 DTC 启用 XA 事务

$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

此命令为托管实例 DTC 启用 XA 事务

示例 3 为以前提取的托管实例启用 DTC

$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

此命令通过传递托管实例对象来启用托管实例 DTC。

示例 4 为以前提取的 DTC 对象启用 XA 事务

$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

此命令通过传递 DTC 对象为 DTC 启用 XA 事务。

示例 5 启用具有特定资源 ID 的 DTC

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

此命令通过传递 DTC 的资源 ID 来启用托管实例 DTC。

参数

-AllowInboundEnabled

启用入站流量。

参数属性

类型:	Nullable<T>[Boolean]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AllowOutboundEnabled

启用出站流量。

参数属性

类型:	Nullable<T>[Boolean]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AsJob

在后台运行 cmdlet。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Authentication

身份验证类型。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DtcEnabled

已启用 DTC 的状态。

参数属性

类型:	Nullable<T>[Boolean]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	2
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ExternalDnsSuffixSearchList

外部 DNS 后缀搜索列表。

参数属性

类型:	List<T>[String]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	3
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Force

跳过执行作的确认消息。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputObject

托管实例 DTC 的输入对象。

参数属性

类型:	AzureSqlManagedInstanceDtcModel
默认值:	None
支持通配符:	False
不显示:	False

参数集

SetByInputObjectParameterSet

Position:	0
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InstanceName

托管实例的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

SetByNameParameterSet

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InstanceObject

托管实例的输入对象。

参数属性

类型:	AzureSqlManagedInstanceModel
默认值:	None
支持通配符:	False
不显示:	False

参数集

SetByParentObjectParameterSet

Position:	0
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

SetByNameParameterSet

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceId

托管实例 DTC 的资源 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

SetByResourceIdParameterSet

Position:	0
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SnaLu6point2TransactionsEnabled

已启用 SNA LU 6.2 事务的状态。

参数属性

类型:	Nullable<T>[Boolean]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-XaTransactionsDefaultTimeout

XA 事务默认超时。

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-XaTransactionsEnabled

已启用 XA 事务的状态。

参数属性

类型:	Nullable<T>[Boolean]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-XaTransactionsMaximumTimeout

XA 事务最大超时。

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

Set-AzSqlInstanceDtc

语法

SetByNameParameterSet （默认值）

SetByParentObjectParameterSet

SetByInputObjectParameterSet

SetByResourceIdParameterSet

说明

示例

示例 1 为托管实例启用 DTC

示例 2 为 DTC 启用 XA 事务

示例 3 为以前提取的托管实例启用 DTC

示例 4 为以前提取的 DTC 对象启用 XA 事务

示例 5 启用具有特定资源 ID 的 DTC

参数

-AllowInboundEnabled

参数属性

参数集

-AllowOutboundEnabled

参数属性

参数集

-AsJob

参数属性

参数集

-Authentication

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DtcEnabled

参数属性

参数集

-ExternalDnsSuffixSearchList

参数属性

参数集

-Force

参数属性

参数集

-InputObject

参数属性

参数集

-InstanceName

参数属性

参数集

-InstanceObject

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-ResourceId

参数属性

参数集

-SnaLu6point2TransactionsEnabled

参数属性

参数集

-WhatIf

参数属性

参数集

-XaTransactionsDefaultTimeout

参数属性

参数集

-XaTransactionsEnabled

参数属性

参数集

-XaTransactionsMaximumTimeout

参数属性

参数集

CommonParameters

输入

AzureSqlManagedInstanceModel

AzureSqlManagedInstanceDtcModel

String

输出

AzureSqlManagedInstanceDtcModel

相关链接