다음을 통해 공유

Set-AzSqlInstanceDtc

모듈:
Az.Sql Module

Azure SQL Managed Instance 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 Managed Instance 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]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AllowOutboundEnabled

아웃바운드 트래픽을 사용하도록 설정합니다.

매개 변수 속성

형식:

Nullable<T>[Boolean]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AsJob

백그라운드에서 cmdlet을 실행합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Authentication

인증 유형입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DtcEnabled

DTC 사용 상태.

매개 변수 속성

형식:

Nullable<T>[Boolean]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:2
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ExternalDnsSuffixSearchList

외부 DNS 접미사 검색 목록입니다.

매개 변수 속성

형식:

List<T>[String]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:3
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Force

작업을 수행하기 위한 확인 메시지를 건너뜁니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InputObject

관리되는 인스턴스 DTC의 입력 개체입니다.

매개 변수 속성

형식:AzureSqlManagedInstanceDtcModel
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByInputObjectParameterSet
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InstanceName

관리되는 인스턴스의 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByNameParameterSet
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InstanceObject

관리되는 인스턴스의 입력 개체입니다.

매개 변수 속성

형식:AzureSqlManagedInstanceModel
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByParentObjectParameterSet
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceGroupName

리소스 그룹의 이름입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByNameParameterSet
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceId

관리되는 인스턴스 DTC의 리소스 ID입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SetByResourceIdParameterSet
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SnaLu6point2TransactionsEnabled

SNA LU 6.2 트랜잭션을 사용하도록 설정된 상태입니다.

매개 변수 속성

형식:

Nullable<T>[Boolean]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-XaTransactionsDefaultTimeout

XA 트랜잭션의 기본 시간 제한입니다.

매개 변수 속성

형식:

Nullable<T>[Int32]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-XaTransactionsEnabled

XA 트랜잭션을 사용하도록 설정된 상태입니다.

매개 변수 속성

형식:

Nullable<T>[Boolean]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-XaTransactionsMaximumTimeout

XA 트랜잭션의 최대 시간 제한입니다.

매개 변수 속성

형식:

Nullable<T>[Int32]

Default value:None
와일드카드 지원:False
DontShow: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