Get-CsNetworkSite
Última modificación del tema: 2012-03-23
Recupera uno o más sitios de red definidos para el control de admisión de llamadas (CAC) o Enhanced 9-1-1 (E9-1-1).
Sintaxis
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Los sitios de red son las oficinas o ubicaciones configuradas dentro de cada región de una implementación de CAC o E9-1-1. Este cmdlet recupera las configuraciones de uno o más sitios existentes.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsNetworkSite de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSite"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
El identificador único del sitio de red que se quiere recuperar. Los sitios se crean únicamente en el ámbito global, de modo que no es necesario especificar el ámbito. Solo deberá especificar el id. de sitio (el valor de este id. coincide con el NetworkSiteID del sitio de red). |
Filter |
Opcional |
Cadena de caracteres |
Una cadena comodín que permite recuperar varios sitios basándose en la coincidencia entre la Identidad del sitio y el valor de Filter. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera la información del sitio de red de la réplica local de Almacén de administración central, en lugar de recuperarla de Almacén de administración central. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Recupera un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsNetworkSite
Al llamar a Get-CsNetworkSite sin ningún parámetro, se devuelven todos los sitios de red configurados para CAC o E9-1-1 dentro de la implementación de Microsoft Lync Server 2010.
-------------------------- Ejemplo 2 --------------------------
Get-CsNetworkSite -Identity Redmond
Este comando recupera el sitio con la Identidad (y, por definición, el NetworkSiteID) Redmond.
-------------------------- Ejemplo 3 --------------------------
Get-CsNetworkSite -Filter NA*
El comando del Ejemplo 3 llama a Get-CsNetworkSite con el parámetro Filter. El valor del parámetro Filter es NA*, de modo que este comando recuperará todos los sitios cuya identidad comience con la cadena NA seguida de cualquier cantidad de caracteres. Esta acción recuperará sitios como NARedmond, NAVancouver y NAChicago.
-------------------------- Ejemplo 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
En el Ejemplo 4 se usan dos cmdlets, Get-CsNetworkSite y Where-Object, para recuperar todos los sitios que forman parte de la región NorthAmerica. El comando empieza por llamar a Get-CsNetworkSite sin ningún parámetro, para recuperar todos los sitios de red. A continuación, se transfiere esta colección de sitios a Where-Object, que filtra la colección en busca de todos los sitios cuya propiedad NetworkRegionID sea igual a (-eq) NorthAmerica.