< Back

Remove-AzureRmIntegrationAccountReceivedIcn

Tue Jan 29, 2019 9:51 pm

NAME Remove-AzureRmIntegrationAccountReceivedIcn



SYNOPSIS

This cmdlet removes a specific received interchange control number per agreement and control number value.





SYNTAX

Remove-AzureRmIntegrationAccountReceivedIcn -AgreementName <String> [-AgreementType {X12 | Edifact}] -ControlNumberValue <String> [-DefaultProfile

<IAzureContextContainer>] -Name <String> -ResourceGroupName <String> [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

This cmdlet is meant to be used in disaster recovery scenarios to remove a received interchange control number from the integration account so

that the B2B connector may process again the message when duplicate number detection is enabled. In rare occasions the received interchange

control number may be reserved shortly before a disaster and before the B2B connector rejects the interchange as erroneous. In such occasions the

operation may want to enable the recovery site to process again the same interchange after its payload is corrected. Please do provide the

"-AgreementType" parameter to specify whether X12 or Edifact control numbers to return





PARAMETERS

-AgreementName <String>

The integration account agreement name.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-AgreementType <String>

The integration account agreement type.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ControlNumberValue <String>

The integration account control number value.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

The integration account name.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ResourceGroupName <String>

The integration account resource group name.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String







OUTPUTS

System.Object







NOTES









Example 1



PS C:\\> Get-AzureRmIntegrationAccountReceivedIcn -AgreementType "X12" -ResourceGroupName "groupName" -Name "accountName" -AgreementName

"X12AgreementName" -ControlNumberValue "000000641"

Get-AzureRmIntegrationAccountReceivedIcn : The existing recevied control number '000000641' for agreement 'X12AgreementName' is not in a valid

format.

At line:1 char:1

+ Get-AzureRmIntegrationAccountReceivedIcn -ResourceGroupName "groupName ...

+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+ CategoryInfo : CloseError: (:) [Get-AzureRmIntegrationAccountReceivedIcn], PSInvalidOperationException

+ FullyQualifiedErrorId : Microsoft.Azure.Commands.LogicApp.Cmdlets.GetAzureIntegrationAccountReceivedIcnCommand



PS C:\\> Remove-AzureRmIntegrationAccountReceivedIcn -AgreementType "X12" -ResourceGroupName "groupName" -Name "accountName" -AgreementName

"X12AgreementName" -ControlNumberValue "000000641"

PS C:\\> Get-AzureRmIntegrationAccountReceivedIcn -AgreementType "X12" -ResourceGroupName "groupName" -Name "accountName" -AgreementName

"X12AgreementName" -ControlNumberValue "000000641"

Get-AzureRmIntegrationAccountReceivedIcn : The session 'X12-ICN-X12AgreementName-000000641' could not be found in integration account

'accountName'.

At line:1 char:1

+ Get-AzureRmIntegrationAccountReceivedIcn -ResourceGroupName "groupName ...

+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+ CategoryInfo : CloseError: (:) [Get-AzureRmIntegrationAccountReceivedIcn], CloudException

+ FullyQualifiedErrorId : Microsoft.Azure.Commands.LogicApp.Cmdlets.GetAzureIntegrationAccountReceivedIcnCommand



Attempts to get a received X12 interchange control number which content is not in a valid format. Removes the received X12 interchange control

number. Confirms the received X12 interchange control number was removed by attempting to get it again.





Example 2



PS C:\\> Get-AzureRmIntegrationAccountReceivedIcn -AgreementType "Edifact" -ResourceGroupName "groupName" -Name "accountName" -AgreementName

"EdifactAgreementName" -ControlNumberValue "000000641"

Get-AzureRmIntegrationAccountReceivedIcn : The existing recevied control number '000000641' for agreement 'EdifactAgreementName' is not in a valid

format.

At line:1 char:1

+ Get-AzureRmIntegrationAccountReceivedIcn -ResourceGroupName "groupName ...

+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+ CategoryInfo : CloseError: (:) [Get-AzureRmIntegrationAccountReceivedIcn], PSInvalidOperationException

+ FullyQualifiedErrorId : Microsoft.Azure.Commands.LogicApp.Cmdlets.GetAzureIntegrationAccountReceivedIcnCommand



PS C:\\> Remove-AzureRmIntegrationAccountReceivedIcn -AgreementType "Edifact" -ResourceGroupName "groupName" -Name "accountName" -AgreementName

"EdifactAgreementName" -ControlNumberValue "000000641"

PS C:\\> Get-AzureRmIntegrationAccountReceivedIcn -AgreementType "Edifact" -ResourceGroupName "groupName" -Name "accountName" -AgreementName

"EdifactAgreementName" -ControlNumberValue "000000641"

Get-AzureRmIntegrationAccountReceivedIcn : The session 'Edifact-ICN-EdifactAgreementName-000000641' could not be found in integration account

'accountName'.

At line:1 char:1

+ Get-AzureRmIntegrationAccountReceivedIcn -ResourceGroupName "groupName ...

+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+ CategoryInfo : CloseError: (:) [Get-AzureRmIntegrationAccountReceivedIcn], CloudException

+ FullyQualifiedErrorId : Microsoft.Azure.Commands.LogicApp.Cmdlets.GetAzureIntegrationAccountReceivedIcnCommand



Attempts to get a received Edifact interchange control number which content is not in a valid format. Removes the received Edifact interchange

control number. Confirms the received Edifact interchange control number was removed by attempting to get it again.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... eceivedicn

Get-AzureRmIntegrationAccountReceivedIcn

Set-AzureRmIntegrationAccountReceivedIcn