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

Отображение служб с помощью командлетов AppFabric

  • Статья

В этом разделе описывается отображение служб и экземпляров служб с помощью командлетов AppFabric.

Примечание

Чтобы выполнить командлет AppFabric вручную, откройте консоль Windows PowerShell для AppFabric, введите соответствующий командлет и нажмите клавишу ВВОД. Дополнительные сведения о выполнении командлетов см. в разделе Запуск командлетов AppFabric. Сведения о классах и общих параметрах, используемых в синтаксических операторах в данном документе, см. в руководствеСправочник по Windows PowerShell для AppFabric.

Получение служб приложения

Командлет Get-ASAppService отображает все службы, доступные в определенной области. В следующей таблице описаны параметры этого командлета.

Поле Описание

-Root (необязательный)

Если этот параметр указан, не следует указывать параметры –Uri, -SiteName и –ServiceObject. При использовании этого параметра командлет возвращает все службы, размещенные на локальном сервере в среде IIS и WAS.

Get-ASAppService –Root

-SiteName (необязательный)

Если этот параметр указан, не следует указывать параметры –Root, –Uri и –ServiceObject. При использовании этого параметра командлет возвращает все службы, размещенные на указанном веб-сайте.

Get-ASAppService –SiteName “Default Web Site”

-VirtualPath (необязательный)

Необязательный параметр, используется вместе с -SiteName, если не определены параметры –Uri и –ServiceObject. Указывает виртуальный путь к службе или приложению, например /MyDir1/MyApp1/POService.svc.

Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/MyWFServiceApplication”

-Uri (необязательный)

Если этот параметр указан, то не должны указываться параметры -SiteName, -VirtualPath и -ServiceObject. Задает URI сайта, приложения или службы Если параметр указан, возвращаются только службы, доступные по этому URI.

Get-ASAppService –Uri “https://localhost/MyWFServiceApplication”

-ApplicationObject (необязательный)

Если этот параметр указан, то не должны указываться параметры -SiteName, -VirtualPath и -Uri. Как правило, этот параметр используется для конвейеризации выходных данных из командлета Get-ASAppService.

Get-Application | Get-ASAppService

-Count (необязательный)

Возвращает количество служб.

Get-ASAppService -Count

Дополнительные сведения об этом командлете см. в описании Get-ASAppService.

Получение экземпляра службы

Командлет Get-ASAppServiceInstance отображает сведения об объектах экземпляров службы из одного или нескольких хранилищ сохраняемости. Командлет Get-ASAppServiceInstance опрашивает заданный набор хранилищ сохраняемости и возвращает коллекцию экземпляров службы, соответствующих указанным параметрам запроса. В следующей таблице описаны параметры этого командлета.

Поле Описание

-Root (необязательный)

Если этот параметр указан, не следует указывать параметры –Uri, -SiteName и –ServiceObject. При использовании этого параметра командлет возвращает все экземпляры службы на локальном сервере.

Get-ASAppServiceInstance –Root

-SiteName (необязательный)

Если этот параметр указан, то не должны указываться параметры -Uri и –ServiceObject. Задает имя сайта. Если параметр задан, возвращаются только экземпляры служб, размещенных в указанном сайте.

Get-ASAppServiceInstance –SiteName “Default Web Site”

-VirtualPath (необязательный)

Необязательный параметр, используется вместе с -SiteName, если не определены параметры –Uri и –ServiceObject. Указывает виртуальный путь к службе или приложению, например /MyDir1/MyApp1/POService.svc.

Get-ASAppServiceInstance –SiteName “Default Web Site” –VirtualPath “/MyWFServiceApplication”

-Uri (необязательный)

Если этот параметр указан, то не должны указываться параметры -SiteName, -VirtualPath и -ServiceObject. Задает URI сайта, приложения или службы Если параметр указан, возвращаются только экземпляры служб, доступные по этому URI.

Get-ASAppServiceInstance –Uri “https://localhost/MyWFServiceApplication”

-ServiceInfo (необязательный)

Если этот параметр указан, то не должны указываться параметры -SiteName, -VirtualPath и -Uri. Указывает объект ServiceInfo, используемый для определения экземпляров службы, сведения о которых следует вернуть. Как правило, этот параметр используется для конвейеризации выходных данных из командлета Get-ASAppService.

Get-ASAppService | Get-ASAppServiceInstance

-ApplicationInfo (необязательный)

Если этот параметр указан, то не должны указываться параметры -SiteName, -VirtualPath и -Uri. Указывает объект ApplicationInfo, используемый для определения экземпляров служб, сведения о которых следует вернуть. Как правило, этот параметр используется для конвейеризации выходных данных из командлета Get-ASApplication.

Get-ASApplication | Get-ASAppServiceInstance

-Count (необязательный)

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

//root level is the default level
Get-ASAppServiceInstance -Count

-CreatedTimeFrom (необязательный)

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

Get-ASAppServiceInstance -CreatedTimeFrom 1/1/2009

-CreatedTimeTo (необязательный)

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

Get-ASAppServiceInstance -CreatedTimeTo 6/1/2009
Get-ASAppServiceInstance -CreatedTimeFrom 1/1/2009 -CreatedTimeTo 6/1/2009

-MachineName (необязательный)

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

Get-ASAppServiceInstance -MachineName

-ModifiedTimeFrom (необязательный)

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

Get-ASAppServiceInstance -ModifiedTimeFrom 1/1/2009

-ModifiedTimeTo (необязательный)

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

Get-ASAppServiceInstance -ModifiedTimeTo 6/1/2009
Get-ASAppServiceInstance -ModifiedTimeFrom 1/1/2009 -ModifiedTimeTo 6/1/2009

-ExceptionName (необязательный)

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

-MaxRows (необязательный)

Указывает количество возвращаемых строк (экземпляров служб).

Get-ASAppServiceInstance –MaxRows 100

-InstanceId (необязательный)

Указывает идентификатор экземпляра (в виде GUID) возвращаемого экземпляра службы. Идентификатор экземпляра уникально идентифицирует экземпляр службы. Если этот параметр указан, возвращается экземпляр с этим идентификатором (при наличии такого экземпляра).

-ServiceType (необязательный)

Указывает службу по типу. Если параметр указан, возвращаются только экземпляры этого типа службы. Тип службы может быть выражен в виде полного или частичного пути или в виде полного или частичного имени и пространства имен .NET Framework. При указании типа службы по пространству имен необходимо использовать символ # для отделения типа службы от пространства имен. Например, если полным именем службы в среде CLR .NET Framework является Contoso.Web.Sales.POService, значением параметра должна быть строка "Contoso.Web.Sales#POService".

Нельзя явно указывать подстановочные знаки, но этот параметр содержит неявные подстановочные знаки (*), которые помещаются в начало и конец предоставленного значения. Например, "Contoso/Service.svc" воспринимается как "*Contoso/Service.svc*", а "Sales#POService" — как "*Sales#POService*".

-Status (необязательный)

Указывает состояние экземпляра. Если параметр указан, по запросу возвращаются только экземпляры служб с указанным состоянием. Допустимыми значениями являются: Запущенные (работает), Suspended (приостановка) и Completed (выполнен).

Get-ASAppServiceInstance -Status Completed

-Condition (необязательный)

Указывает состояние экземпляра. Если параметр указан, по запросу возвращаются только экземпляры служб с указанным состоянием. Допустимыми значениями являются: Active (активен), Idle (бездействует), Exception (исключение), UserSuspension (приостановка пользователем), Successful (успешно), Cancelled (отмена) и Terminated (завершение).

Get-ASAppServiceInstance -Condition Cancelled

-GroupBy (необязательный)

Указывает поле, которое используется для группирования возвращенного количества экземпляров служб. Допустимыми значениями являются: UniqueApplication, UniqueService, ServiceType, Exception, Status, Site и MachineName.

Get-ASAppServiceInstance –GroupBy Status

-OrderBy (необязательный)

Служит для отображения экземпляров служб, упорядоченных в порядке убывания по последнему времени обновления.

-ExcludeSubFolders (необязательный)

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

-Timeout (необязательный)

Указывает, как долго командлет должен ожидать ответа из базы данных. Значением является значение времени в формате чч:мм:сс. Минимальным значением может быть 00:00:01 (1 секунда), максимальным — значение TimeSpan.MaxValue. Если параметр не указан, используется значение по умолчанию, равное 00:02:00 (2 мин.).

-ReturnBinaryProperties (необязательный)

Если параметр указан, возвращает массив бинарных свойств метаданных из возвращенного объекта InstanceInfo.

Дополнительные сведения об этом командлете см. в описании Get-ASAppServiceInstance.

  2012-03-05