Поделиться через

Get-ServiceFabricDeployedApplication

  • Ссылка
Модуль:
ServiceFabric

Возвращает приложения Service Fabric на указанном узле.

Синтаксис

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>]

Описание

Командлет Get-ServiceFabricDeployedApplication получает приложения Service Fabric, развернутые на указанном узле.

Service Fabric создает рабочие, журналы и временные каталоги на узле для каждого развернутого приложения. Так как имена каталогов содержат идентификатор приложения, имена каталогов не могут быть угадываться. Если параметр DeployedApplicationStatus активен, Get-ServiceFabricDeployedApplication возвращает имена каталогов в возвращаемых значениях WorkDirectory, LogDirectory и TempDirectory . При скачивании DeployedApplicationStatus значения WorkDirectory, LogDirectory и TempDirectory имеют значение NULL.

Развернутые службы приложений хранят сохраненные данные в WorkDirectory. Для отладки или диагностики другому приложению или процессу может потребоваться знать расположение WorkDirectory.

Развернутые службы приложений должны хранить журнал в LogDirectory , созданном Service Fabric. Пользовательский отправитель файлов журнала может потребоваться знать расположение. Расположение LogDirectory может потребоваться для диагностики, а также, если приложение на определенном узле не работает должным образом.

По умолчанию этот запрос возвращает ряд результатов, ограниченных конфигурацией максимального размера сообщения. Пакеты SDK и кластеры версии 6.1 или более поздней поддерживают функции разбиения по страницам, которые удаляют это ограничение; Новое поведение будет возвращать результаты независимо от конфигурации максимального размера сообщения, так как этот запрос выполняет цикл по всем возвращенным страницам прозрачно. Сведения об использовании разбиения по страницам и других новых функциональных возможностей см. в наборе параметров UsePagedAPI. Выбор новых фильтров сигналов запросу для использования разбиения по страницам под капотом. В противном случае выберите "UsePaging", чтобы выбрать страничный запрос.

Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster .

Примеры

Пример 1. Получение приложения 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

Эта команда возвращает развернутые приложения. В этом примере deployedApplicationStatus является активным и, следовательно, Get-ServiceFabricDeployedApplication возвращает имена каталогов в возвращаемых значениях WorkDirectory, LogDirectory и TempDirectory .

Пример 2. Получение приложения fabric:/samples/VQueueApp2

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

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

Эта команда возвращает развернутые приложения. В этом примере deployedApplicationStatus загружается и, следовательно, команда возвращает значения NULL для WorkDirectory, LogDirectory и TempDirectory.

Пример 3. Получение приложений с максимальными результатами

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

Эта команда получает все приложения Service Fabric, развернутые на предоставленном узле в кластере, который помещается на страницу. Размер страницы ограничен двумя элементами, настроенными параметром MaxResults. Так как мы выбрали параметр GetSinglePage, этот запрос вернет только одну страницу результатов. MaxResults нельзя использовать без этого параметра. При выборе параметра Verbose выводится возвращаемое значение токена продолжения. Это значение можно использовать в последующем запросе для получения следующей страницы результатов. Вы также можете получить доступ к возвращенным маркеру продолжения, сохранив возвращенные результаты и доступ к свойству ContinuationToken. Свойство "ContinuationToken" имеет значение NULL, нет возвращаемого маркера продолжения.

Пример 4. Получение приложения с маркером продолжения

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

Эта команда получает приложения Service Fabric, которые учитывают предоставленный маркер продолжения, который помещается на одну страницу. Маркер продолжения, предоставленный этому запросу, совпадает с приведенным выше примером. В этом примере кластера существует только один элемент, который учитывает токен продолжения. Если на узле слишком много приложений, которые учитывают предоставленный маркер продолжения, чтобы поместиться в одну страницу результатов, эта конфигурация запроса вернет компиляцию всех возвращенных страниц, циклически прокрутя их. затем запрос вернет вектор всех результатов. Чтобы получить только одну страницу результатов, выберите параметр GetSinglePage.

Пример 5. Получение приложения с состоянием работоспособности

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

Эта команда возвращает приложение Service Fabric, которое соответствует указанному имени приложения и включает его состояние работоспособности.

Параметры

-ApplicationName

Указывает универсальный код ресурса (URI) приложения Service Fabric. Командлет получает развернутое приложение, соответствующее указанному имени приложения. Этот запрос точно соответствует. Например, структура URI:/App не будет соответствовать fabric:/App1. Если указано имя приложения, возвращается не более одного результата. Если предоставленное имя приложения не соответствует ни одному приложению на узле, запрос возвращает значение NULL.

Тип:Uri
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ContinuationToken

Указывает маркер продолжения, который можно использовать для получения следующей страницы результатов запроса.

Если слишком много результатов учитывают предоставленные фильтры, они могут не помещаться в одно сообщение. Разбиение по страницам используется для учета этого путем разделения коллекции возвращаемых результатов на отдельные страницы. Маркер продолжения используется для того, чтобы узнать, где слева предыдущая страница, несущая значение только для самого запроса. Это значение должно быть создано при выполнении этого запроса и может быть передано в следующий запрос запроса, чтобы получить последующие страницы. Значение маркера продолжения, отличное от NULL, возвращается как часть результата, только если есть следующая страница. Если это значение предоставляется без параметра -GetSinglePage, запрос вернет все страницы, начиная со значения токена продолжения.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-GetSinglePage

Указывает, будет ли запрос возвращать одну страницу результатов запроса со значением маркера продолжения или все страницы, объединенные в один список результатов. Если этот параметр выбран, то на последующие страницы отвечает вызывающий объект запроса.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IncludeHealthState

Указывает, вернет ли запрос состояние работоспособности развернутых приложений. Если этот параметр не указан, возвращается состояние работоспособности "Неизвестно". При выборе запрос выполняется параллельно с узлом и службой системы работоспособности, прежде чем результаты будут объединены. В результате запрос требует больше ресурсов и времени.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MaxResults

Указывает максимальное количество элементов результата, которые можно вернуть на страницу. Это определяет верхнюю границу для количества возвращаемых результатов, а не минимума. Например, если страница помещается не более 1000 возвращаемых элементов в соответствии с ограничениями максимального размера сообщения, определенными в конфигурации, а значение MaxResults равно 2000, возвращается только 1000 результатов, даже если 2000 элементов результата соответствуют описанию запроса.

Для этого значения требуется выбрать флаг GetSinglePage; В противном случае он будет игнорироваться.

Тип:Int64
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NodeName

Указывает имя узла Service Fabric. Командлет получает приложения, развернутые на указанном узле.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TimeoutSec

Указывает период времени ожидания (в секундах) для операции.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UsePaging

Указывает, будет ли запрос выстраивается. Если этот запрос не выбран, этот запрос не будет работать, если на одной странице слишком много результатов, как определено в конфигурации максимального размера сообщения. При выборе этого параметра этот запрос настраивается для возврата всех результатов независимо от конфигурации максимального размера сообщения. Это делается путем получения страничных результатов и прозрачного перебирания по всем страницам от имени вызывающего объекта.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

System.String

System.Uri

Выходные данные

System.Object