Get-CsNetworkInterface
Ultima modifica dell'argomento: 2012-03-23
Restituisce le informazioni sulle interfacce di rete utilizzate sui computer che eseguono i ruoli del server o i servizi Microsoft Lync Server 2010.
Sintassi
Get-CsNetworkInterface [-Identity <NetworkInterfaceIdentity>] [-ComputerFqdn <Fqdn>]
Get-CsNetworkInterface [-ComputerFqdn <Fqdn>] [-Filter <String>]
Descrizione dettagliata
Per trasferire le informazioni da un computer ad un altro, è necessario che i computer dispongano delle interfacce di rete: connessioni tra un computer e la rete. I computer che eseguono i ruoli del server o i servizi Lync Server 2010 devono avere almeno un'interfaccia di rete; altrimenti non saranno in grado di comunicare con altri computer. Tuttavia, i computer possono avere più interfacce di rete; ad esempio, Edge Server potrebbe avere un'interfaccia per la connessione alla rete interna e una seconda interfaccia per la connessione a Internet. Il cmdlet Get-CsNetworkInterface consente agli amministratori di ottenere informazioni sulle interfacce di rete attualmente in uso sui computer che eseguono i ruoli del server o i servizi Lync Server.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsNetworkInterface può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterface"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità interfaccia di rete |
Identificatore univoco dell'interfaccia di rete da ottenere. L'identità (Identity) di un'interfaccia di rete è composta da tre parti: Il nome di dominio completo del computer (ad esempio, atl-cs-001.litwareinc.com). Il "lato" dell'interfaccia di rete (Primary; Internal; External; PSTN). Il lato indica il tipo di traffico per cui viene utilizzata la porta. Il numero dell'interfaccia di rete per il lato specifico. Ad esempio: -Identity "atl-cs-001.litwareinc.com/Primary/1". I parametri Identity, ComputerFqdn e Filter devono essere utilizzati separatamente; ad esempio, non è possibile eseguire un comando che utilizza sia ComputerFqdn che Identity. Inoltre, non è possibile utilizzare i caratteri jolly per specificare l'identità (Identity). Per utilizzare i caratteri jolly, è necessario utilizzare il parametro Filter. Se i parametri Identity, ComputerFqdn e Filter non vengono utilizzati, il cmdlet Get-CsNetworkInterface restituisce le informazioni su tutte le interfacce di rete attualmente in uso nei computer che eseguono un ruolo del server o un servizio Lync Server. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per specificare le interfacce di rete da ottenere. Ad esempio, questa sintassi restituisce informazioni sull'interfaccia di rete Primary utilizzata su tutti i computer che eseguono un ruolo del server o un servizio Lync Server: -Filter "*/Primary/*". |
ComputerFqdn |
Facoltativo |
Stringa |
Nome di dominio completo del computer per cui si desidera ottenere informazioni sull'interfaccia di rete. Ad esempio, per ottenere le informazioni sull'interfaccia di rete del computer atl-cs-001.litwareinc.com (e solo per quel computer), utilizzare la seguente sintassi: -ComputerFqdn atl-cs-001.litwareinc.com. |
Tipi di input
Nessuno. Get-CsNetworkInterface non accetta input tramite pipeline.
Tipi restituiti
Get-CsNetworkInterface restituisce un'istanza dell'oggetto Microsoft.Rtc.Management.Xds.DisplayNetworkInterface.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsNetworkInterface
Il comando precedente consente di ottenere le informazioni su tutte le interfacce di rete configurate per l'organizzazione.
-------------------------- Esempio 2 ------------------------
Get-CsNetworkInterface -Identity atl-cs-001.litwareinc.com/Primary/1
Il comando riportato nell'Esempio 2 consente di ottenere le informazioni su una singola interfaccia di rete: l'interfaccia con Identity atl-cs-001.litwareinc.com.com/Primary/1.
-------------------------- Esempio 3 ------------------------
Get-CsNetworkInterface -Filter "*.litwareinc.com*"
Nell'Esempio 3 si ottengono le informazioni su tutte le interfacce di rete nel dominio litwareinc.com. Per ottenere questo risultato, viene incluso il parametro Filter insieme al valore "*.litwareinc.com*". Il valore del filtro restituisce solo i dati relativi a quelle interfacce la cui identità (Identity) include il valore "litwareinc.com".
-------------------------- Esempio 4 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -eq "192.168.0.240"}
Nell'Esempio 4 si ottengono le informazioni su tutte le interfacce di rete configurate per l'indirizzo IP 192.168.0.240. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsNetworkInterface senza alcun parametro; ciò restituisce una raccolta di tutte le interfacce di rete configurate per l'utilizzo nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle interfacce in cui la proprietà IPAddress è uguale a 192.168.0.240.
-------------------------- Esempio 5 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -like "192.168.0.*"}
Il comando riportato nell'Esempio 5 è una variante del comando riportato nell'Esempio 4; in questo caso, tuttavia, si ottengono informazioni per tutte le interfacce di rete configurate per la subnet "192.168.0.*". Per ottenere questo risultato, viene recuperata una raccolta di tutte le interfacce di rete che poi viene inviata al cmdlet Where-Object che seleziona solo quelle interfacce in cui IPAddress inizia con il valore "192.168.0.".
-------------------------- Esempio 6 ------------------------
Get-CsNetworkInterface | Where-Object {$_.Interface -eq "External"}
Il comando precedente consente di ottenere tutte le interfacce di rete configurate per l'accesso esterno. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsNetworkInterface senza alcun parametro; ciò restituisce una raccolta di tutte le interfacce di rete attualmente in uso. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quegli elementi in cui la proprietà Interface è uguale a External.