Compartir a través de

Get-ServiceFabricDeployedApplication

  • Referencia
Módulo:
ServiceFabric

Obtiene las aplicaciones de Service Fabric en un nodo especificado.

Sintaxis

Get-ServiceFabricDeployedApplication
   [-NodeName] <String>
   [[-ApplicationName] <Uri>]
   [-UsePaging]
   [-GetSinglePage]
   [-IncludeHealthState]
   [-MaxResults <Int64>]
   [-ContinuationToken <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricDeployedApplication
   [-NodeName] <String>
   [[-ApplicationName] <Uri>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

El cmdlet get-ServiceFabricDeployedApplication obtiene las aplicaciones de Service Fabric implementadas en un nodo especificado.

Service Fabric crea directorios de trabajo, registro y temporales en el nodo para cada aplicación implementada. Dado que los nombres de directorio incluyen el identificador de aplicación, no se pueden adivinar los nombres de directorio. Cuando el DeployedApplicationStatus es Active, get-ServiceFabricDeployedApplication devuelve los nombres de directorio en elWorkDirectory , LogDirectoryy valores devueltos de TempDirectory. Cuando se descarga el de DeployedApplicationStatus, los valores de WorkDirectory, LogDirectoryy TempDirectory son NULL.

Los servicios de aplicación implementados almacenan sus datos persistentes en el WorkDirectory. Para fines de depuración o diagnóstico, es posible que sea necesario conocer la ubicación del WorkDirectory.

Los servicios de aplicación implementados deben almacenar su registro en el LogDirectory creado por Service Fabric. Es posible que sea necesario conocer la ubicación de un cargador personalizado de los archivos de registro. La ubicación del logDirectory puede ser necesaria para fines de diagnóstico, así como cuando una aplicación en un nodo determinado no funciona según lo previsto.

De forma predeterminada, esta consulta devuelve una serie de resultados limitados a la configuración de tamaño máximo del mensaje. Los SDK y clústeres versiones 6.1 o posteriores admiten la funcionalidad de paginación que elimina esta restricción; el nuevo comportamiento será devolver los resultados independientemente de la configuración de tamaño máximo de mensaje porque esta consulta recorre todas las páginas devueltas de forma transparente. Para usar la paginación y otras nuevas funcionalidades, consulte el conjunto de parámetros "UsePagedAPI". Selección de las nuevas señales de filtros en la consulta para usar la paginación en segundo plano. De lo contrario, seleccione "UsarPaging" para participar en consultas paginadas.

Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster.

Ejemplos

Ejemplo 1: Obtener la aplicación "fabric:/samples/CalcApp2"

PS C:\> Get-ServiceFabricDeployedApplication -NodeName "VIPULM4-RK01-BD01" -ApplicationName fabric:/samples/CalcApp2

ApplicationName           : fabric:/samples/CalcApp2
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\work
LogDirectory              : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\log
TempDirectory             : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\temp
HealthState               : Unknown

Este comando devuelve aplicaciones implementadas. En este ejemplo, el de DeployedApplicationStatus es Activo y, por lo tanto, Get-ServiceFabricDeployedApplication devuelve los nombres de directorio en el WorkDirectory, LogDirectoryy valores devueltos de TempDirectory.

Ejemplo 2: Obtener la aplicación "fabric:/samples/VQueueApp2"

PS C:\> Get-ServiceFabricDeployedApplication -NodeName VIPULM4-RK01-BD01 fabric:/samples/VQueueApp2

ApplicationName           : fabric:/samples/VQueueApp2
ApplicationTypeName       : VolatileQueueApp
DeployedApplicationStatus : Downloading
HealthState               : Unknown

Este comando devuelve aplicaciones implementadas. En este ejemplo, el de DeployedApplicationStatus es Downloading y, por lo tanto, el comando devuelve valores null para WorkDirectory, LogDirectoryy TempDirectory.

Ejemplo 3: Obtención de aplicaciones con resultados máximos

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState               : Unknown

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\temp
HealthState               : Unknown

VERBOSE: Continuation Token: fabric:/samples/PQueueApp1

Este comando obtiene todas las aplicaciones de Service Fabric implementadas en el nodo proporcionado del clúster que caben en una página. El tamaño de la página se limita aún más a dos elementos, tal como lo configura el parámetro MaxResults. Dado que hemos seleccionado la opción "GetSinglePage", esta consulta devolverá solo una página de resultados. MaxResults no se puede usar sin esta opción. Al seleccionar "Verbose" se imprime el valor del token de continuación devuelto. Este valor se puede usar en una consulta posterior para obtener la siguiente página de resultados. También puede acceder al token de continuación devuelto guardando los resultados devueltos y accediendo a la propiedad "ContinuationToken". La propiedad "ContinuationToken" es null es que no hay ningún token de continuación devuelto.

Ejemplo 4: Obtención de la aplicación con token de continuación

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ContinuationToken fabric:/samples/PQueueApp1 -UsePaging

ApplicationName           : fabric:/samples/VQueueApp1
ApplicationTypeName       : VolatileQueueApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\temp
HealthState               : Unknown

Este comando obtiene las aplicaciones de Service Fabric que respetan el token de continuación proporcionado que cabe en una sola página. El token de continuación proporcionado a esta consulta es el mismo que se devuelve del ejemplo anterior. En este clúster de ejemplo, solo hay un elemento que respeta el token de continuación. Si hay demasiadas aplicaciones que respetan el token de continuación proporcionado en el nodo para ajustarse a una página de resultados, esta configuración de consulta devolverá una compilación de todas las páginas devueltas, recorrerlas de forma transparente; A continuación, la consulta devolverá un vector de todos los resultados. Para obtener solo una página de resultados, seleccione la opción "GetSinglePage".

Ejemplo 5: Obtención de la aplicación con estado de mantenimiento

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ApplicationName fabric:/samples/CalculatorApp -IncludeHealthState

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState               : Ok

Este comando obtiene la aplicación de Service Fabric que coincide con el nombre de aplicación proporcionado e incluye su estado de mantenimiento.

Parámetros

-ApplicationName

Especifica el identificador uniforme de recursos (URI) de una aplicación de Service Fabric. El cmdlet obtiene la aplicación implementada que coincide con el nombre de aplicación especificado. Esta consulta hace una coincidencia exacta. Por ejemplo, el tejido de URI:/App no coincidirá con fabric:/App1. Como máximo, se devolverá un resultado si se proporciona el nombre de la aplicación. Si el nombre de aplicación proporcionado no coincide con ninguna aplicación en el nodo, la consulta devuelve null.

Tipo:Uri
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ContinuationToken

Especifica el token de continuación que se puede usar para recuperar la página siguiente de los resultados de la consulta.

Si hay demasiados resultados que respetan los filtros proporcionados, es posible que no se ajusten a un mensaje. La paginación se usa para tener en cuenta esto dividiendo la colección de resultados devueltos en páginas independientes. El token de continuación se usa para saber dónde se dejó la página anterior, llevando la importancia solo a la propia consulta. Este valor se debe generar a partir de la ejecución de esta consulta y se puede pasar a la siguiente solicitud de consulta para obtener páginas posteriores. Un valor de token de continuación que no es NULL se devuelve como parte del resultado solo si hay una página posterior. Si este valor se proporciona sin la opción -GetSinglePage, la consulta devolverá todas las páginas a partir del valor del token de continuación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GetSinglePage

Especifica si la consulta devolverá una página de resultados de consulta con un valor de token de continuación o todas las páginas combinadas en una lista de resultados. Si se selecciona esta opción, es responsabilidad del autor de la llamada de la consulta comprobar si hay páginas posteriores.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IncludeHealthState

Especifica si la consulta devolverá el estado de mantenimiento de las aplicaciones implementadas. Si no se especifica este parámetro, el estado de mantenimiento devuelto es "Unknown". Cuando se selecciona, la consulta pasa en paralelo al nodo y al servicio del sistema de mantenimiento antes de combinar los resultados. Como resultado, la consulta es más costosa y puede tardar más tiempo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxResults

Especifica el número máximo de elementos de resultado que se pueden devolver por página. Esto define el límite superior para el número de resultados devueltos, no como mínimo. Por ejemplo, si la página se ajusta como máximo a 1000 elementos devueltos según las restricciones máximas de tamaño de mensaje definidas en la configuración, y el valor MaxResults se establece en 2000, solo se devuelven 1000 resultados, incluso si 2000 elementos de resultado coinciden con la descripción de la consulta.

Este valor requiere la selección de la marca GetSinglePage; se omitirá de lo contrario.

Tipo:Int64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NodeName

Especifica el nombre de un nodo de Service Fabric. El cmdlet obtiene las aplicaciones implementadas en el nodo que especifique.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UsePaging

Especifica si la consulta se paginará. Si no se selecciona, esta consulta no funcionará cuando haya demasiados resultados para ajustarse a una página, tal como se define en la configuración de tamaño máximo de mensaje. Al seleccionar esta opción, se configura esta consulta para devolver todos los resultados, independientemente de la configuración de tamaño máximo del mensaje. Para ello, obtiene resultados paginados y recorre en bucle todas las páginas de forma transparente en nombre del autor de la llamada.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

System.String

System.Uri

Salidas

System.Object