共用方式為

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

Description

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：使用特定資源識別碼啟用 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 的資源識別碼，以啟用受控執行個體 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
別名:參見

參數集

(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 的資源識別碼。

參數屬性

類型: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。

輸入

AzureSqlManagedInstanceModel

AzureSqlManagedInstanceDtcModel

String

輸出

AzureSqlManagedInstanceDtcModel