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:\&gt;
</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:\&gt; 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:\&gt; 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:\&gt; 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:\&gt; 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>