Get-CsNetworkSite
Ultima modifica dell'argomento: 2012-03-23
Recupera uno o più siti della rete definiti per Controllo di ammissione di chiamata o per la funzionalità per le chiamate di emergenza.
Sintassi
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
I siti di rete sono gli uffici o le postazioni configurate in ogni area di una distribuzione di Controllo di ammissione di chiamata o della funzionalità per le chiamate di emergenza. Questo cmdlet consente di recuperare le impostazioni per uno o più siti esistenti.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsNetworkSite i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSite"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsGlobalRelativeIdentity |
Identificatore univoco del sito della rete che si desidera recuperare. I siti vengono creati solo nell'ambito globale, pertanto non è necessario specificare un ambito. Al contrario, è richiesto di specificare l'ID sito. Si noti che questo valore equivale a NetworkSiteID per il sito della rete. |
Filter |
Facoltativo |
Stringa |
Una stringa di caratteri jolly che consente di recuperare più siti in base alla corrispondenza fra l'identità del sito e il valore Filter. |
LocalStore |
Facoltativo |
Parametro opzionale |
Recupera le informazioni relative al sito di rete dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso. |
Tipi di input
Nessuno.
Tipi restituiti
Recupera un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsNetworkSite
Get-CsNetworkSite, senza l'inclusione di parametri, restituirà tutti i siti della rete configurati per Controllo di ammissione di chiamata o per la funzionalità per le chiamate di emergenza nella distribuzione di Microsoft Lync Server 2010.
-------------------------- Esempio 2 --------------------------
Get-CsNetworkSite -Identity Redmond
Questo comando consente di recuperare il sito con Identity Redmond (per definizione, NetworkSiteID).
-------------------------- Esempio 3 --------------------------
Get-CsNetworkSite -Filter NA*
Il comando mostrato nell'esempio 3 chiama Get-CsNetworkSite con il parametro Filter. Il valore del parametro Filter è NA* e indica che questo comando recupererà tutti i siti con valore Identity che inizia con la stringa NA seguita da un numero qualsiasi di caratteri. Il comando restituisce siti, quali NARedmond, NAVancouver e NAChicago.
-------------------------- Esempio 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
Nell'esempio 4 vengono utilizzati due cmdlet, Get-CsNetworkSite e Where-Object, per recuperare tutti i siti che fanno parte dell'area NorthAmerica. Il comando chiama innanzitutto Get-CsNetworkSite senza parametri per recuperare tutti i siti della rete. La raccolta di siti viene quindi inviata tramite pipe a Where-Object, che la filtra ricercando tutti i siti con proprietà NetworkRegionID uguale a (-eq) NorthAmerica.