DeleteParty (exemple BizTalk Server)

Article
10/14/2023

L'exemple DeleteParty décrit la suppression d'un tiers spécifique.

Avertissement

Les scripts de déploiement devenus inutiles après le déploiement doivent être supprimés. Les scripts d'administration et autres scripts conservés doivent être sécurisés à l'aide de listes de contrôle d'accès et étroitement surveillés.

Notes

Avant de pouvoir supprimer un tiers, vous devez d'abord en créer un. Pour ce faire, vous pouvez exécuter l’exemple PartyResolution (BizTalk Server Sample).

Prérequis

Vous devez disposer de BizTalk Server privilèges administratifs pour utiliser les objets d’administration de cet exemple.
La stratégie d'exécution de Windows PowerShell doit autoriser l'exécution des scripts. Pour plus d’informations, consultez about_Execution_Policies.

Fonctions de l'exemple

Cet exemple, écrit en Microsoft Visual C#, à l'aide d'objets du modèle objet de l'Explorateur BizTalk (ExplorerOM), effectue les opérations suivantes :

requête d'un tiers spécifique ;
suppression de ce tiers ;
gestion de toutes erreurs de telle sorte que les informations significatives soient renvoyées à l'utilisateur.

Accès à l'exemple

Cet exemple se trouve à l’emplacement suivant du Kit de développement logiciel (SDK) :

<Chemin d’accès> des exemples\Administration\ExplorerOM\DeleteParty\

Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.

Fichier(s)	Description
App.ico, AssemblyInfo.cs, DeleteParty.csproj, DeleteParty.sln, DeleteParty.cs	Fichiers de projet, de solution et sources pour la création d'une application de ligne de commande Visual C# qui supprime un tiers spécifié.

Pour créer et initialiser l'exemple

Dans Visual Studio, ouvrez le fichier de solution DeleteParty.sln.
Dans le menu Générer, cliquez sur Générer la solution.

Pour exécuter l'exemple

Dans une fenêtre de commande, accédez au dossier suivant :

<Chemin d’accès> des exemples\Administration\ExplorerOM\DeleteParty\bin\Debug\
Exécutez le fichier DeleteParty.exe, en passant l'un des deux arguments de ligne de commande suivants :
- <PartyName>. Nom d’une partie à supprimer. Si le nom du tiers contient des espaces, placez-le entre guillemets.
- /?. Affiche de l’aide.
  
  Par exemple :
```
DeleteParty "My Party #3"
```
OU
```
DeleteParty /?
```

Exemple de script Windows PowerShell

Le fragment de script Windows PowerShell suivant peut être utilisé pour illustrer les mêmes fonctionnalités des classes ExplorerOM :


#===================#
#=== Main Script ===#
#===================#

#=== Make sure the ExplorerOM assembly is loaded ===#

[void] [System.reflection.Assembly]::LoadWithPartialName("Microsoft.BizTalk.ExplorerOM")

#=== Connect to the BizTalk Management database ===#

$Catalog = New-Object Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer
$Catalog.ConnectionString = "SERVER=.;DATABASE=BizTalkMgmtDb;Integrated Security=SSPI"

#=======================================#
#=== If no party name is specified   ===#
#=== just list the parties.          ===#
#=======================================#

if ($args[0] -eq $null)
{
  Write-Host `r`nNo party name provided for delete operation.`r`n`r`nListing Parties on local Biztalk Server:

  $Catalog.Parties | Format-List Name
}

#==========================================#
#=== Delete the specified party by name ===#
#==========================================#

else
{
  $party = $Catalog.Parties[$args[0]]
  Write-Host `r`nRemoving Party named `"($args[0])`"`r`n
  $catalog.RemoveParty($party)
  $catalog.SaveChanges()
}

L'exemple de script attend un nom de tiers unique pour le transmettre en tant qu'argument de ligne de commande. Il recherche ce tiers à l'aide de son nom et tente de le supprimer. Si aucun argument de ligne de commande ne lui est transmis, ce script répertorie tous les tiers du serveur BizTalk local. Voici un exemple de sortie du script :

PS C:\> .\DeletePart.ps1

No party name provided for delete operation.

Listing Parties on local Biztalk Server:

Name : Party1

Name : Party3

Name : Party2

PS C:\> .\DeletePart.ps1 Party3

Removing Party named " Party3 "

PS C:\> .\DeletePart.ps1

No party name provided for delete operation.

Listing Parties on local Biztalk Server:

Name : Party1

Name : Party2

Voir aussi

Admin-ExplorerOM (dossier d’exemples BizTalk Server)

Partager via