Get-CsService
上次修改主題的時間: 2012-03-23
傳回 Microsoft Lync Server 2010 基礎結構中所使用的服務和伺服器角色相關資訊。服務是已部署於 Lync Server 2010 集區中角色的執行個體。例如,您可能有全部執行監控伺服器服務的集區。
語法
Get-CsService [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]
Get-CsService [-ApplicationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ApplicationDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagement <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagementDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ConferencingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-Director <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-EdgeServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-TrustedApplicationPool <SwitchParameter>]
Get-CsService [-FileStore <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ManagementServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MediationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-PstnGateway <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-Registrar <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-WebServer <SwitchParameter>]
Get-CsService [-Filter <String>] [-PoolFqdn <String>]
詳細描述
可以在 Lync Server 2010 中找到的功能通常都會表示為服務或伺服器角色。例如,您可以設定 Lync Server,自動儲存每個要在組織內執行的立即訊息工作階段記錄。若要執行這項動作,您必須安裝 封存伺服器 伺服器角色。服務和伺服器角色可以在您安裝 Lync Server 的同時加以設定,或者在啟動和執行該軟體之後,再進行設定。
Get-CsService 指令程式讓您能夠傳回組織內所執行之伺服器角色及服務的相關資訊。若呼叫時未指定任何其他參數,Get-CsService 便會傳回有關您所有服務和伺服器角色的詳細資訊。或者,您可以使用 PoolFqdn 參數,將傳回的資料限制為指定的集區。此外,可以使用任意數量的切換參數,將傳回的資料限制為特定類型的服務 切換參數是不需要參數值的參數。例如,下列命令會傳回有關您所有封存伺服器的資訊:
Get-CsService –ArchivingServer
請注意,每個命令只能使用一個這類切換參數。下列命令嘗試同時傳回封存伺服器和監控伺服器的相關資訊,因而將會失敗:
Get-CsService –ArchivingServer –MonitoringServer
若要傳回多個伺服器角色的資訊,您可以使用 Get-CsService 傳回服務資料的完整集合,然後將該資料傳送到 Where-Object Cmdlet:
Get-CsService | Where-Object {$_.Role –eq "ArchivingServer" –or $_.Role –eq "MonitoringServer"}
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Get-CsService Cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsService"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要傳回之特定服務或伺服器角色的唯一識別碼。例如:-Identity "Registrar:atl-cs-001.litwareinc.com"。 |
Filter |
選用 |
字串 |
讓您能夠使用萬用字元來指定要傳回的服務 (或多個服務)。您無法在同一個命令中同時使用 Identity 和 Filter 參數。 |
ApplicationDatabase |
選用 |
切換參數 |
傳回組織所使用之應用程式資料庫的相關資訊。應用程式資料庫是由 應用程式服務 所使用。 |
ApplicationServer |
選用 |
切換參數 |
傳回 應用程式服務 的相關資訊。應用程式服務 提供一種方式可以執行藉由使用 Microsoft Unified Communications Managed API (UCMA) 所建立的應用程式。 |
ArchivingDatabase |
選用 |
切換參數 |
傳回組織所使用之封存資料庫的相關資訊。封存資料庫會儲存立即訊息工作階段的記錄。 |
ArchivingServer |
選用 |
切換參數 |
傳回組織所使用之封存伺服器的相關資訊。封存伺服器讓您能夠儲存立即訊息工作階段的記錄。 |
CentralManagement |
選用 |
切換參數 |
傳回組織所使用之 中央管理服務 的相關資訊。系統使用 中央管理服務 將組態資料傳送至執行 Lync Server 2010 服務的電腦。 |
CentralManagementDatabase |
選用 |
切換參數 |
傳回組織所使用之 中央管理存放區 的相關資訊。中央管理存放區 會為 Lync Server 保留組態資訊。 |
ConferencingServer |
選用 |
切換參數 |
傳回組織所使用之 A/V 會議服務 的相關資訊。系統使用 A/V 會議服務 進行會議。 |
Director |
選用 |
切換參數 |
傳回組織所使用之 Director 的相關資訊。Director 有權處理使用者要求和使用者驗證,但不會保留使用者帳戶。Director 通常可用來處理外部使用者的要求。 |
EdgeServer |
選用 |
切換參數 |
傳回組織所使用之 Edge Server 的相關資訊。Edge Server 提供內部網路與網際網路之間的連線。 |
FileStore |
選用 |
切換參數 |
傳回組織所使用之檔案存放區的相關資訊。檔案存放區可以用來保留 Lync Server 檔案,例如,宣告服務所使用的音訊檔案。 |
ManagementServer |
選用 |
切換參數 |
傳回組織所使用之 中央管理伺服器 的相關資訊。通常會與前端伺服器一起收集 中央管理伺服器,且該伺服器負責存取 中央管理存放區 中的資訊。 |
MediationServer |
選用 |
切換參數 |
傳回組織所使用之中繼伺服器的相關資訊。中繼伺服器可協助提供介於 Enterprise Voice 網路與公用交換電話網路 (PSTN) 之間的橋接器。 |
MonitoringServer |
選用 |
切換參數 |
傳回組織所使用之監控伺服器的相關資訊。監控伺服器可用來追蹤 Enterprise Voice 電話使用方式和通話品質。 |
MonitoringDatabase |
選用 |
切換參數 |
傳回組織所使用之監控資料庫的相關資訊。監控資料庫會儲存 Enterprise Voice 電話使用方式和通話品質資訊。 |
PoolFqdn |
選用 |
字串 |
裝載服務或伺服器角色之集區的完整網域名稱 (FQDN)。如果使用 PoolFqdn 參數且未指定服務特定的參數,則將傳回可在該集區中找到的所有服務和伺服器角色。 |
ProvisionServer |
選用 |
切換參數 |
傳回組織所使用之佈建伺服器服務的相關資訊。憑證佈建服務用來管理 Lync Server 憑證。 |
ProvisionDatabase |
選用 |
切換參數 |
傳回組織所使用之佈建資料庫的相關資訊。佈建資料庫會保留 Lync Server 憑證的相關資訊。 |
PstnGateway |
選用 |
切換參數 |
傳回組織所使用的公用交換電話網路 (PSTN) 閘道相關資訊。PSTN 閘道會將來自 Enterprise Voice 裝置的信號轉譯為 PSTN 裝置能瞭解的信號,反之亦然。 |
Registrar |
選用 |
切換參數 |
傳回組織所使用之登錄器的相關資訊。登錄器可用來驗證使用者,並持續追蹤使用者的目前狀態。 |
TrustedApplicationPool |
選用 |
切換參數 |
傳回組織所使用之信任應用程式集區的相關資訊。信任的應用程式集區主控執行信任的應用程式之電腦。 |
UserDatabase |
選用 |
切換參數 |
傳回組織所使用之 使用者資料庫 的相關資訊。使用者資料庫會儲存使用者伺服器服務所需的資料。 |
UserServer |
選用 |
切換參數 |
傳回組織所使用之 使用者服務 服務的相關資訊。使用者服務 服務提供諸如下列的資訊:使用者複寫、In-Band 佈建、目前狀態發行與通知,以及連絡人卡片交換。 |
WebServer |
選用 |
切換參數 |
傳回組織所使用之 Web 服務 服務的相關資訊。Web 服務 服務會主控諸如通訊錄服務的 Web 應用程式。 |
輸入類型
無。Get-CsService 不會接受管線傳送的資料。
傳回類型
Get-CsService 會根據呼叫指令程式時所使用的參數,傳回不同的物件。例如,如果您加入 MonitoringDatabase 參數,Get-CsService 會傳回 Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase 物件的執行個體。若要判斷使用其他參數傳回的物件,可使用這其中一個參數來呼叫 Get-CsService,然後將傳回的物件傳送到 Get-Member 指令程式。例如:Get-CsService -Registrar | Get-Member。
範例
-------------------------- 範例 1 ------------------------
Get-CsService
範例 1 所示的命令會傳回組織中目前正在執行的所有 Lync Server 2010 服務和伺服器角色相關資訊。
-------------------------- 範例 2 ------------------------
Get-CsService -ApplicationServer
範例 2 只會傳回 應用程式服務 的相關資訊。只需使用適當的參數,即可傳回其他服務/伺服器角色的資訊。例如,此命令會傳回檔案存放區的相關資訊:
Get-CsService -FileStore
-------------------------- 範例 3 ------------------------
Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity
上述命令會回報每個位於 atl-cs-001.litwareinc.com 集區之服務的 Identity。為了執行此作業,命令會先呼叫 Get-CsService 搭配 PoolFqdn 參數,以便只傳回在 atl-cs-001.litwareinc.com 集區找到的服務和伺服器角色。然後將此集合傳送到 Select-Object 指令程式,它會回報集合中每個項目的 Identity。
-------------------------- 範例 4 ------------------------
Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}
在範例 4 中,會傳回所有在 Redmond 站台找到的服務/伺服器角色資訊。作法上會先呼叫 Get-CsService 且不指定任何參數,以便傳回組織目前所使用的所有服務和伺服器角色的集合。然後將此資料傳送到 Where-Object 指令程式,這只會挑選出 SiteID 屬性等於 site:Redmond 的項目。
-------------------------- 範例 5 ------------------------
Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}
範例 5 所示的命令會傳回將登錄器列為相依服務的所有服務相關資訊。為達成此目的,會呼叫 Get-CsService,以傳回目前使用之所有服務和伺服器角色的集合。然後將此集合傳送到 Where-Object,這會選取 DependentServiceList 屬性包含字串值 "Registrar" 的每個項目。Where-Object 準則可以使用 -like 運算子和萬用字元值 "*Registrar*" 來指定。