HelpCache/TestDtc.psm1-help.xml
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Test-Dtc</command:name> <maml:description> <maml:para>Performs a test on two specified computers to determine whether they can participate in networked transactions.</maml:para> </maml:description> <maml:copyright> <maml:para /> </maml:copyright> <command:verb>Test</command:verb> <command:noun>Dtc</command:noun> <dev:version /> </command:details> <maml:description> <maml:para>This cmdlet performs the following tests on two computers to determine whether they can participate in networked transactions: </maml:para> <maml:para>1. Checks if the required firewall rules are enabled.</maml:para> <maml:para>2. Checks if the Microsoft Distributed Transaction Coordinator (MSDTC) network security settings are correctly configured for network transactions.</maml:para> <maml:para>3. Checks if the two computers can ping each other.</maml:para> <maml:para>4. Checks if a transaction can be propagated between the two computers.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Test-Dtc</maml:name> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases=""> <maml:name>LocalComputerName</maml:name> <maml:description> <maml:para>Specifies the virtual server name of the MSDTC instance on the local computer to be tested.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases=""> <maml:name>RemoteComputerName</maml:name> <maml:description> <maml:para>Specifies the virtual server name of the MSDTC instance on the remote computer to be tested.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases=""> <maml:name>ResourceManagerPort</maml:name> <maml:description> <maml:para>Specifies the port number to be used by the MSDTC Diagnostic Resource Manager. If not specified port 3002 is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases=""> <maml:name>LocalComputerName</maml:name> <maml:description> <maml:para>Specifies the virtual server name of the MSDTC instance on the local computer to be tested.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases=""> <maml:name>RemoteComputerName</maml:name> <maml:description> <maml:para>Specifies the virtual server name of the MSDTC instance on the remote computer to be tested.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="false" globbing="false" pipelineInput="false" position="named" aliases=""> <maml:name>ResourceManagerPort</maml:name> <maml:description> <maml:para>Specifies the port number to be used by the MSDTC Diagnostic Resource Manager. If not specified port 3002 is used.</maml:para> </maml:description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue></dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name></maml:name> <maml:uri></maml:uri> <maml:description> <maml:para /> </maml:description> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name></maml:name> <maml:uri></maml:uri> <maml:description> <maml:para /> </maml:description> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:returnValue> </command:returnValues> <command:terminatingErrors /> <command:nonTerminatingErrors /> <command:examples> <command:example> <maml:title></maml:title> <maml:introduction> <maml:para></maml:para> </maml:introduction> <dev:code>PS C:\> </dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText /> </command:commandLine> </command:commandLines> </command:example> <command:example> <maml:title></maml:title> <maml:introduction> <maml:para></maml:para> </maml:introduction> <dev:code>The following example shows how to use Test-Dtc on the local computer. PS C:\> Test-Dtc -LocalComputerName $env:COMPUTERNAME -Verbose VERBOSE: ": Firewall rule for "RPC Endpoint Mapper" is enabled." VERBOSE: ": Firewall rule for "DTC incoming connections" is enabled." VERBOSE: ": Firewall rule for "DTC outgoing connections" is enabled." VERBOSE: CSVM1554203-GU: AuthenticationLevel: Mutual VERBOSE: CSVM1554203-GU: InboundTransactionsEnabled: True VERBOSE: CSVM1554203-GU: OutboundTransactionsEnabled: True VERBOSE: CSVM1554203-GU: RemoteClientAccessEnabled: False VERBOSE: CSVM1554203-GU: RemoteAdministrationAccessEnabled: True VERBOSE: CSVM1554203-GU: XATransactionsEnabled: True VERBOSE: CSVM1554203-GU: LUTransactionsEnabled: True The following example shows how to use Test-Dtc by specifying a remote computer name and a resource manager port. PS C:\> Test-Dtc -LocalComputerName $env:COMPUTERNAME -RemoteComputerName CSVM1554501-GU -ResourceManagerPort 17100 -Verbose VERBOSE: ": Firewall rule for "RPC Endpoint Mapper" is enabled." VERBOSE: ": Firewall rule for "DTC incoming connections" is enabled." VERBOSE: ": Firewall rule for "DTC outgoing connections" is enabled." VERBOSE: CSVM1554203-GU: AuthenticationLevel: Mutual VERBOSE: CSVM1554203-GU: InboundTransactionsEnabled: True VERBOSE: CSVM1554203-GU: OutboundTransactionsEnabled: True VERBOSE: CSVM1554203-GU: RemoteClientAccessEnabled: False VERBOSE: CSVM1554203-GU: RemoteAdministrationAccessEnabled: True VERBOSE: CSVM1554203-GU: XATransactionsEnabled: True VERBOSE: CSVM1554203-GU: LUTransactionsEnabled: True VERBOSE: Loading module from path 'C:\Windows\System32\WindowsPowerShell\v1.0\Modules\CimCmdlets\CimCmdlets.psd1'. VERBOSE: Loading 'Assembly' from path 'C:\Windows\Microsoft.Net\assembly\GAC_MSIL\Microsoft.Management.Infrastructure.CimCmdlets\v4.0_1.0.0.0__31bf3856ad364e 35\Microsoft.Management.Infrastructure.CimCmdlets.dll'. VERBOSE: Loading 'Assembly' from path 'C:\Windows\Microsoft.Net\assembly\GAC_MSIL\Microsoft.Management.Infrastructure\v4.0_1.0.0.0__31bf3856ad364e35\Microsoft.Management.Infrastructure.dll'. VERBOSE: Exporting cmdlet 'Get-CimInstance'. VERBOSE: Exporting cmdlet 'Get-CimSession'. VERBOSE: Exporting cmdlet 'New-CimSession'. VERBOSE: Exporting cmdlet 'New-CimSessionOption'. VERBOSE: Exporting cmdlet 'Remove-CimSession'. VERBOSE: Exporting cmdlet 'Get-CimAssociatedInstance'. VERBOSE: Exporting cmdlet 'Get-CimClass'. VERBOSE: Exporting cmdlet 'Invoke-CimMethod'. VERBOSE: Exporting cmdlet 'New-CimInstance'. VERBOSE: Exporting cmdlet 'Register-CimIndicationEvent'. VERBOSE: Exporting cmdlet 'Remove-CimInstance'. VERBOSE: Exporting cmdlet 'Set-CimInstance'. VERBOSE: Importing cmdlet 'Get-CimAssociatedInstance'. VERBOSE: Importing cmdlet 'Get-CimClass'. VERBOSE: Importing cmdlet 'Get-CimInstance'. VERBOSE: Importing cmdlet 'Get-CimSession'. VERBOSE: Importing cmdlet 'Invoke-CimMethod'. VERBOSE: Importing cmdlet 'New-CimInstance'. VERBOSE: Importing cmdlet 'New-CimSession'. VERBOSE: Importing cmdlet 'New-CimSessionOption'. VERBOSE: Importing cmdlet 'Register-CimIndicationEvent'. VERBOSE: Importing cmdlet 'Remove-CimInstance'. VERBOSE: Importing cmdlet 'Remove-CimSession'. VERBOSE: Importing cmdlet 'Set-CimInstance'. VERBOSE: "CSVM1554501-GU Operating System Version: 6.2.8179." VERBOSE: "CSVM1554501-GU: Firewall rule for "RPC Endpoint Mapper" is enabled." VERBOSE: "CSVM1554501-GU: Firewall rule for "DTC incoming connections" is enabled." VERBOSE: "CSVM1554501-GU: Firewall rule for "DTC outgoing connections" is enabled." VERBOSE: CSVM1554501-GU: AuthenticationLevel: Mutual VERBOSE: CSVM1554501-GU: InboundTransactionsEnabled: True VERBOSE: CSVM1554501-GU: OutboundTransactionsEnabled: True VERBOSE: CSVM1554501-GU: RemoteClientAccessEnabled: False VERBOSE: CSVM1554501-GU: RemoteAdministrationAccessEnabled: True VERBOSE: CSVM1554501-GU: XATransactionsEnabled: True VERBOSE: CSVM1554501-GU: LUTransactionsEnabled: True VERBOSE: "Pinging computer CSVM1554203-GU from CSVM1554501-GU succeeded." VERBOSE: "Pinging computer CSVM1554501-GU from CSVM1554203-GU succeeded." VERBOSE: CSVM1554203-GU: OleTx: a9f3f4c0-cc24-4f34-bfc3-6b6d819dab84 VERBOSE: CSVM1554501-GU: OleTx: 94a24f8a-3040-4fa2-9f27-833ffb2037bc VERBOSE: CSVM1554203-GU: XA: f35da6a2-26d2-4d14-98e6-1a8feea41bc8 VERBOSE: CSVM1554501-GU: XA: 15614187-293b-4a39-92ce-6740b1ea526c VERBOSE: CSVM1554203-GU: UIS: 7f8d8ad0-7096-47fd-9aab-5d561852c93b VERBOSE: CSVM1554501-GU: UIS: e1a97aaa-003c-4b61-a978-8601e8438d5f VERBOSE: "This diagnostic test will attempt to carry out a transaction propagation between CSVM1554203-GU and CSVM1554501-GU. It requires that a TCP port is opened on CSVM1554203-GU so that a Test Resource Manager can participate in network transactions." "You have specified 17100 as the 'ResourceManagerPort'." "Please open port 17100 in the firewall to proceed with the test." VERBOSE: "Test resource manager started." VERBOSE: "A new PSSession to CSVM1554501-GU created." VERBOSE: "Transaction propagated from CSVM1554203-GU to CSVM1554501-GU using PULL propagation." VERBOSE: "Transaction propagated from CSVM1554203-GU to CSVM1554501-GU using PUSH propagation." VERBOSE: "Test Resource Manager Verbose Log:" VERBOSE: DtcDiagRM:17100 is now listening at http://CSVM1554203-GU:17100/DTCDiagRM. VERBOSE: Resolution of IP address to hostname failed, just using IP address: 2001:4898:2a:1006:c041:b365:30de:b2e3. VERBOSE: DtcDiagRM:17100 received a request for PropagationToken from 2001:4898:2a:1006:c041:b365:30de:b2e3. VERBOSE: DtcDiagRM:17100 created Transaction 4a546251-db38-4fe9-91bb-22e532deb68b. VERBOSE: DtcDiagRM:17100 obtained a PropagationToken for Transaction 4a546251-db38-4fe9-91bb-22e532deb68b from DTC. VERBOSE: Resolution of IP address to hostname failed, just using IP address: 2001:4898:2a:1006:c041:b365:30de:b2e3. VERBOSE: ResourceManager DtcDiagRM:17100 received a request for an ExportCookie from 2001:4898:2a:1006:c041:b365:30de:b2e3. VERBOSE: DtcDiagRM:17100 created Transaction cc088777-03c6-43cc-83f6-06539b83e1fd. VERBOSE: DtcDiagRM:17100 obtained an ExportCookie for Transaction cc088777-03c6-43cc-83f6-06539b83e1fd from DTC. VERBOSE: Resource Manager DtcDiagRM:17100 - 24aeb805-7ef5-4410-9a19-f5fddf93c4d2 is removed. The following example shows how to use Test-Dtc to test turning off inbound transactions on a local computer. PS C:\> Test-Dtc -LocalComputerName $env:COMPUTERNAME -RemoteComputerName CSVM1554501-GU -ResourceManagerPort 17100 -Verbose VERBOSE: ": Firewall rule for "RPC Endpoint Mapper" is enabled." VERBOSE: ": Firewall rule for "DTC incoming connections" is enabled." VERBOSE: ": Firewall rule for "DTC outgoing connections" is enabled." VERBOSE: CSVM1554203-GU: AuthenticationLevel: Mutual VERBOSE: CSVM1554203-GU: InboundTransactionsEnabled: False WARNING: "CSVM1554203-GU: Inbound transactions are not allowed and this computer cannot participate in network transactions." VERBOSE: CSVM1554203-GU: OutboundTransactionsEnabled: True VERBOSE: CSVM1554203-GU: RemoteClientAccessEnabled: False VERBOSE: CSVM1554203-GU: RemoteAdministrationAccessEnabled: True VERBOSE: CSVM1554203-GU: XATransactionsEnabled: True VERBOSE: CSVM1554203-GU: LUTransactionsEnabled: True VERBOSE: Operation '' complete. VERBOSE: "CSVM1554501-GU Operating System Version: 6.2.8179." VERBOSE: "CSVM1554501-GU: Firewall rule for "RPC Endpoint Mapper" is enabled." VERBOSE: "CSVM1554501-GU: Firewall rule for "DTC incoming connections" is enabled." VERBOSE: "CSVM1554501-GU: Firewall rule for "DTC outgoing connections" is enabled." VERBOSE: CSVM1554501-GU: AuthenticationLevel: Mutual VERBOSE: CSVM1554501-GU: InboundTransactionsEnabled: True VERBOSE: CSVM1554501-GU: OutboundTransactionsEnabled: True VERBOSE: CSVM1554501-GU: RemoteClientAccessEnabled: False VERBOSE: CSVM1554501-GU: RemoteAdministrationAccessEnabled: True VERBOSE: CSVM1554501-GU: XATransactionsEnabled: True VERBOSE: CSVM1554501-GU: LUTransactionsEnabled: True VERBOSE: "Pinging computer CSVM1554203-GU from CSVM1554501-GU succeeded." VERBOSE: "Pinging computer CSVM1554501-GU from CSVM1554203-GU succeeded." VERBOSE: CSVM1554203-GU: OleTx: a9f3f4c0-cc24-4f34-bfc3-6b6d819dab84 VERBOSE: CSVM1554501-GU: OleTx: 94a24f8a-3040-4fa2-9f27-833ffb2037bc VERBOSE: CSVM1554203-GU: XA: f35da6a2-26d2-4d14-98e6-1a8feea41bc8 VERBOSE: CSVM1554501-GU: XA: 15614187-293b-4a39-92ce-6740b1ea526c VERBOSE: CSVM1554203-GU: UIS: 7f8d8ad0-7096-47fd-9aab-5d561852c93b VERBOSE: CSVM1554501-GU: UIS: e1a97aaa-003c-4b61-a978-8601e8438d5f "DTC security settings and firewall settings should be fixed in order to complete the transactions propagation test." At C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MsDtc\TestDtc.psm1:712 char:25 + throw $Strings.NeedDtcSecurityFix + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : OperationStopped: ("DTC security s...pagation test.":String) [], RuntimeException + FullyQualifiedErrorId : "DTC security settings and firewall settings should be fixed in order to complete the transactions propagation test." The following example shows how to use Test-Dtc to test turning off outbound transactions on a local computer. PS C:\> Test-Dtc -LocalComputerName $env:COMPUTERNAME -RemoteComputerName CSVM1554501-GU -ResourceManagerPo rt 17100 -Verbose VERBOSE: ": Firewall rule for "RPC Endpoint Mapper" is enabled." VERBOSE: ": Firewall rule for "DTC incoming connections" is enabled." VERBOSE: ": Firewall rule for "DTC outgoing connections" is enabled." VERBOSE: CSVM1554203-GU: AuthenticationLevel: Mutual VERBOSE: CSVM1554203-GU: InboundTransactionsEnabled: True VERBOSE: CSVM1554203-GU: OutboundTransactionsEnabled: False WARNING: "CSVM1554203-GU: Outbound transactions are not allowed and this computer cannot participate in network transactions." VERBOSE: CSVM1554203-GU: RemoteClientAccessEnabled: False VERBOSE: CSVM1554203-GU: RemoteAdministrationAccessEnabled: True VERBOSE: CSVM1554203-GU: XATransactionsEnabled: True VERBOSE: CSVM1554203-GU: LUTransactionsEnabled: True VERBOSE: Operation '' complete. VERBOSE: "CSVM1554501-GU Operating System Version: 6.2.8179." VERBOSE: "CSVM1554501-GU: Firewall rule for "RPC Endpoint Mapper" is enabled." VERBOSE: "CSVM1554501-GU: Firewall rule for "DTC incoming connections" is enabled." VERBOSE: "CSVM1554501-GU: Firewall rule for "DTC outgoing connections" is enabled." VERBOSE: CSVM1554501-GU: AuthenticationLevel: Mutual VERBOSE: CSVM1554501-GU: InboundTransactionsEnabled: True VERBOSE: CSVM1554501-GU: OutboundTransactionsEnabled: True VERBOSE: CSVM1554501-GU: RemoteClientAccessEnabled: False VERBOSE: CSVM1554501-GU: RemoteAdministrationAccessEnabled: True VERBOSE: CSVM1554501-GU: XATransactionsEnabled: True VERBOSE: CSVM1554501-GU: LUTransactionsEnabled: True VERBOSE: "Pinging computer CSVM1554203-GU from CSVM1554501-GU succeeded." VERBOSE: "Pinging computer CSVM1554501-GU from CSVM1554203-GU succeeded." VERBOSE: CSVM1554203-GU: OleTx: a9f3f4c0-cc24-4f34-bfc3-6b6d819dab84 VERBOSE: CSVM1554501-GU: OleTx: 94a24f8a-3040-4fa2-9f27-833ffb2037bc VERBOSE: CSVM1554203-GU: XA: f35da6a2-26d2-4d14-98e6-1a8feea41bc8 VERBOSE: CSVM1554501-GU: XA: 15614187-293b-4a39-92ce-6740b1ea526c VERBOSE: CSVM1554203-GU: UIS: 7f8d8ad0-7096-47fd-9aab-5d561852c93b VERBOSE: CSVM1554501-GU: UIS: e1a97aaa-003c-4b61-a978-8601e8438d5f "DTC security settings and firewall settings should be fixed in order to complete the transactions propagation test." At C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MsDtc\TestDtc.psm1:712 char:25 + throw $Strings.NeedDtcSecurityFix + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : OperationStopped: ("DTC security s...pagation test.":String) [], RuntimeException + FullyQualifiedErrorId : "DTC security settings and firewall settings should be fixed in order to complete the transactions propagation test." </dev:code> <dev:remarks> <maml:para></maml:para> </dev:remarks> <command:commandLines> <command:commandLine> <command:commandText /> </command:commandLine> </command:commandLines> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Online Version:</maml:linkText> <maml:uri>http://go.microsoft.com/fwlink/?linkid=317546 </maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> </helpItems> |