DeleteParty (ejemplo de BizTalk Server)
El ejemplo DeleteParty muestra cómo eliminar una entidad especificada.
Advertencia
Las secuencias de comandos de implementación se deben quitar después de la implementación si no son necesarias. La lista de control de acceso (ACL) debe proteger y supervisar detalladamente las secuencias de comandos de administración y otras secuencias de comandos que deben permanecer.
Nota
Debe crear una entidad antes de poder eliminarla. Una manera de hacerlo es ejecutar el ejemplo PartyResolution (BizTalk Server Sample).
Requisitos previos
Debe tener BizTalk Server privilegios administrativos para usar los objetos administrativos de este ejemplo.
El script de Windows PowerShell requiere que la directiva de ejecución de Windows PowerShell permita la ejecución de scripts. Para obtener más información, vea about_Execution_Policies.
Descripción del ejemplo
En este ejemplo, escrito en Microsoft Visual C# con objetos del modelo de objetos del Explorador de BizTalk (ExplorerOM), se realizan las operaciones siguientes:
Consultar una entidad especificada.
Eliminar esa entidad.
Administrar errores tales como la devolución al usuario de información significativa.
Ubicación del ejemplo
Este ejemplo se encuentra en la siguiente ubicación de SDK:
<Ruta de acceso de> ejemplos\Administración\ExplorerOM\DeleteParty\
En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.
| Archivos | Descripción |
|---|---|
| App.ico, AssemblyInfo.cs, DeleteParty.csproj, DeleteParty.sln, DeleteParty.cs | Archivos de proyecto, de solución y de origen para generar una aplicación de línea de comandos de Visual C# que elimine una entidad especificada. |
Para generar e inicializar el ejemplo
En Visual Studio, abra el archivo de solución DeleteParty.sln.
En el menú Compilar , haga clic en Compilar solución.
Para ejecutar el ejemplo
En una ventana de comandos, desplácese a la siguiente carpeta:
<Ruta de acceso de> ejemplos\Administración\ExplorerOM\DeleteParty\bin\Debug\
Ejecute el archivo DeleteParty.exe y pase uno de los dos argumentos de línea de comandos siguientes:
<PartyName>. Nombre de una entidad que se va a eliminar. Si el nombre de la entidad contiene espacios, póngalo entre comillas.
/?. Muestra información de ayuda.
Por ejemplo:
DeleteParty "My Party #3"O
DeleteParty /?
Ejemplo de script de Windows PowerShell
El siguiente fragmento de script de Windows PowerShell se puede usar para mostrar las mismas características de las clases 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()
}
El ejemplo del script espera que se pase un único nombre de entidad como argumento de la línea de comandos y busca esa entidad por su nombre e intenta eliminarla. El script mostrará todas las entidades del servidor BizTalk local si no se le pasa ningún argumento de la línea de comandos. A continuación se proporciona el resultado del ejemplo del 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