Compartir a través de

Get-ServiceFabricDeployedApplication

  • Referencia
Módulo:
ServiceFabric

Obtiene las aplicaciones de Service Fabric en un nodo especificado.

Syntax

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 DeployedApplicationStatus es Activo, Get-ServiceFabricDeployedApplication devuelve los nombres de directorio en los valores devueltos WorkDirectory, LogDirectory y TempDirectory . Cuando Se descarga DeployedApplicationStatus , los valores WorkDirectory, LogDirectory y TempDirectory son null.

Los servicios de aplicación implementados almacenan sus datos persistentes en WorkDirectory. Para fines de depuración o diagnóstico, es posible que una aplicación o proceso diferente necesite conocer la ubicación de WorkDirectory.

Los servicios de aplicación implementados deben almacenar su registro en el LogDirectory creado por Service Fabric. Es posible que un cargador personalizado de los archivos de registro necesite conocer la ubicación. La ubicación de 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 los 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 del mensaje, ya que esta consulta recorre en bucle todas las páginas devueltas de forma transparente. Para usar la paginación y otras nuevas funcionalidades, vea el conjunto de parámetros "UsePagedAPI". Selección de las nuevas señales de filtros a 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, DeployedApplicationStatus es Active y, por tanto, Get-ServiceFabricDeployedApplication devuelve los nombres de directorio en los valores devueltos WorkDirectory, LogDirectory y 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, DeployedApplicationStatus es Downloading y, por lo tanto, el comando devuelve valores null para WorkDirectory, LogDirectory y 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, según lo configurado por 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 "Detallado", 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 devuelto por el 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 caber en una página de resultados, esta configuración de consulta devolverá una compilación de todas las páginas devueltas y las recorrerá 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 la aplicación proporcionada 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 realiza 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 del nodo, la consulta devuelve null.

Type:Uri
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 va 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 de tamaño máximo 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; de lo contrario, se omitirá.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsePaging

Especifica si la consulta se paginará. Si no está seleccionada, esta consulta no funcionará cuando haya demasiados resultados para caber en una página, tal como se define en la configuración de tamaño máximo del 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

System.String

System.Uri

Salidas

System.Object