Get-CsNetworkInterface
上次修改主題的時間： 2012-03-23
傳回執行 Microsoft Lync Server 2010 服務或伺服器角色的電腦上，所使用網路介面的相關資訊。
語法
Get-CsNetworkInterface [-Identity <NetworkInterfaceIdentity>] [-ComputerFqdn <Fqdn>]
Get-CsNetworkInterface [-ComputerFqdn <Fqdn>] [-Filter <String>]
詳細描述
為了讓資訊從一部電腦傳輸到另一部電腦，電腦都需要網路介面：電腦與網路之間的連線。執行 Lync Server 2010 服務或伺服器角色的電腦至少必須有一個網路介面；否則無法與其他電腦進行通訊。不過，這些電腦也可以擁有多個網路介面；例如 Edge Server 可能擁有一個介面與內部網路連線，另一個介面與網際網路連線。Get-CsNetworkInterface 指令程式為系統管理員提供一種方法，可以傳回在執行 Lync Server 服務或伺服器角色的電腦上目前使用中之網路介面的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsNetworkInterface Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterface"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
網路介面 Identity |
要傳回之網路介面的唯一識別碼。網路介面 Identity 包含三個部分： 電腦本身的完整網域名稱 (FQDN) (例如 atl-cs-001.litwareinc.com)。 網路介面「端」(主要、內部、外部、公用交換電話網路)。「端」指的是連接埠用在哪一種流量類型。 該特定端的網路介面號碼。 例如：-Identity "atl-cs-001.litwareinc.com/Primary/1"。 Identity、ComputerFqdn 和 Filter 參數必須分開使用；例如，您無法執行同時使用 ComputerFqdn 與 Identity 的命令。此外，您無法在指定 Identity 時使用萬用字元。若要使用萬用字元，請使用 Filter 參數。 如果 Identity (ComputerFqdn) 與 Filter 參數都未使用，則 Get-CsNetworkInterface 會傳回在執行 Lync Server 服務或伺服器角色的電腦上所有目前使用中網路介面的相關資訊。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回的網路介面 (或多個介面) 時使用萬用字元。例如，此語法會傳回執行 Lync Server 服務或伺服器角色之所有電腦上的主要網路介面相關資訊：-Filter "*/Primary/*"。 |
ComputerFqdn |
選用 |
字串 |
要傳回之網路介面資訊的電腦 FQDN。例如，若要傳回電腦 atl-cs-001.litwareinc.com 的網路介面資訊 (且僅針對該電腦)，請使用以下語法：-ComputerFqdn atl-cs-001.litwareinc.com。 |
輸入類型
無。Get-CsNetworkInterface 不接受管線傳送的輸入。
傳回類型
Get-CsNetworkInterface 會傳回 Microsoft.Rtc.Management.Xds.DisplayNetworkInterface 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsNetworkInterface
以上的命令會傳回設定為在組織中使用之所有網路介面的相關資訊。
-------------------------- 範例 2 ------------------------
Get-CsNetworkInterface -Identity atl-cs-001.litwareinc.com/Primary/1
範例 2 所示的命令會傳回單一網路介面的相關資訊：Identity 為 atl-cs-001.litwareinc.com.com/Primary/1 的介面。
-------------------------- 範例 3 ------------------------
Get-CsNetworkInterface -Filter "*.litwareinc.com*"
在範例 3 中，會傳回網域 litwareinc.com 中所有網路介面的相關資訊。為達成此目的，會加入 -Filter 參數搭配篩選值 "*.litwareinc.com*"。此篩選值會將傳回的資料限制為其 Identity 包含字串值 "litwareinc.com" 的介面。
-------------------------- 範例 4 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -eq "192.168.0.240"}
範例 4 會傳回設定為 IP 位址 192.168.0.240 之所有網路介面的相關資訊。若要這樣做，此命令會先呼叫不含任何參數的 Get-CsNetworkInterface；這樣會傳回設定為在組織中使用之所有網路介面的集合。接著，該合會傳送到 Where-Object 指令程式，只挑出 IPAddress 屬性等於 192.168.0.240 的介面。
-------------------------- 範例 5 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -like "192.168.0.*"}
範例 5 所示的命令是顯示在範例 4 中的命令變化；不過，在此例中，所傳回的是為子網路 "192.168.0.*" 所設定之所有網路介面的資訊。透過擷取所有網路介面的集合、將該集合傳送到 Where-Object，然後只挑出 IPAddress 開頭字串值是 "192.168.0." 的介面，可完成這個工作。
-------------------------- 範例 6 ------------------------
Get-CsNetworkInterface | Where-Object {$_.Interface -eq "External"}
以上的命令會傳回已設定為外部存取的所有網路介面。若要達到此目的，會先呼叫不含任何參數的 Get-CsNetworkInterface；這會傳回目前使用中的所有網路介面集合。接著，此集合會傳送到 Where-Object 指令程式，只選取 Interface 屬性等於 External 的項目。