Set-AzSqlInstanceDtc

模組:

Az.Sql

設定 Azure SQL 受控實例 DTC 的屬性

語法

PowerShell

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

PowerShell

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

PowerShell

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

PowerShell

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

Set-AzSqlInstanceDtc Cmdlet 會修改 Azure SQL 受控實例 DTC 的屬性。

範例

範例 1 為受控實例啟用 DTC

PowerShell

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 交易

PowerShell

$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

PowerShell

$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 交易

PowerShell

$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 使用特定資源識別碼啟用 DTC

PowerShell

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 的資源識別碼，以啟用受控實例 DTC。

參數

-AllowInboundEnabled

啟用輸入流量。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowOutboundEnabled

啟用輸出流量。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AsJob

在背景中執行 Cmdlet。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Authentication

驗證類型。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DtcEnabled

已啟用 DTC 的狀態。

類型:	Nullable<T>[Boolean]
Position:	2
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExternalDnsSuffixSearchList

外部 DNS 後綴搜尋清單。

類型:	List<T>[String]
Position:	3
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

略過執行動作的確認訊息。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

受控實例 DTC 的輸入物件。

類型:	AzureSqlManagedInstanceDtcModel
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-InstanceName

受控實例的名稱。

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InstanceObject

受控實例的輸入物件。

類型:	AzureSqlManagedInstanceModel
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ResourceGroupName

資源群組的名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceId

受控實例 DTC 的資源標識碼。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-SnaLu6point2TransactionsEnabled

啟用 SNA LU 6.2 交易的狀態。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-XaTransactionsDefaultTimeout

XA 交易預設逾時。

類型:	Nullable<T>[Int32]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-XaTransactionsEnabled

已啟用 XA 交易的狀態。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-XaTransactionsMaximumTimeout

XA 交易逾時上限。

類型:	Nullable<T>[Int32]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

AzureSqlManagedInstanceModel

AzureSqlManagedInstanceDtcModel

String

輸出

AzureSqlManagedInstanceDtcModel

相關連結

• Get-AzSqlInstanceDtc
• SQL 受控實例 DTC 檔