Get-CsSite
Ultima modifica dell'argomento: 2012-03-23
Restituisce le informazioni sui siti creati come parte dell'infrastruttura di Microsoft Lync Server 2010. I siti rappresentano una raccolta di pool Lync Server 2010 e generalmente sono dislocati in diverse aree geografiche. Lync Server include due tipi di siti: siti centro dati e siti remoti (succursali).
Sintassi
Get-CsSite [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSite [-Filter <String>]
Descrizione dettagliata
Con Lync Server 2010 viene introdotto un nuovo concetto nella topologia di Lync Server: i siti. I siti (che non devono essere confusi con i siti Active Directory o Microsoft Exchange Server) sono una raccolta di server e pool Lync Server generalmente organizzati in base all'area geografica e alla larghezza di banda della rete. Ad esempio, se a Redmond tutti i computer si trovano sulla stessa rete LAN con connessioni a bassa latenza ed elevata velocità, è possibile specificare un sito Redmond che includa tutti questi computer. Allo stesso modo, se i computer di Dublin si trovano su una propria LAN e condividono le connessioni ad alta velocità e bassa latenza, si potrebbe creare un sito Dublin a sé stante. I siti hanno un ruolo chiave nella gestione di Lync Server: molti criteri e impostazioni possono essere configurati nell'ambito del sito e ciò semplifica notevolmente operazioni quali l'applicazione di un set di dial plan agli utenti di Redmond e di un set completamente diverso di dial plan agli utenti di Dublino.
Il cmdlet Get-CsSite consente di ottenere le informazioni su tutti i siti dell'organizzazione, inclusi i dati sui pool che costituiscono ciascuno di questi siti.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsSite può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsSite"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
SiteId |
Il nome del sito da ottenere. Si noti che basta specificare il nome del sito; ad esempio: -Identity "Redmond". Non utilizzare il formato "site:Redmond" per specificare l'identità. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per specificare l'identità del sito (o dei siti) da ottenere. Ad esempio, questa sintassi restituisce tutti i pool la cui identità include la stringa "Dublin": -Filter "*Dublin*". Si noti che non è possibile utilizzare entrambi i parametri Filter e Identity nello stesso comando. |
Tipi di input
Nessuno. Get-CsSite non accetta input tramite pipeline.
Tipi restituiti
Get-CsSite restituisce le istanze dell'oggetto Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsSite
Nell'Esempio 1 vengono recuperate le informazioni per tutti i siti di Lync Server.
-------------------------- Esempio 2 --------------------------
Get-CsSite -Identity "Redmond"
Nell'esempio 2, vengono restituite le informazioni su un singolo sito: il sito con Identity Redmond.
-------------------------- Esempio 3 --------------------------
Get-CsSite | Where-Object {$_.SiteType -eq "CentralSite"}
Il comando riportato nell'Esempio 3 restituisce le informazioni sul sito centrale. Per eseguire questa operazione, il comando utilizza il cmdlet Get-CsSite per ottenere una raccolta di tutti i siti configurati per l'utilizzo nella propria organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona l'unico sito in cui la proprietà SiteType è uguale a (-eq) "CentralSite".
-------------------------- Esempio 4 --------------------------
Get-CsSite -Identity "Redmond" | Select-Object -ExpandProperty Pools
Il comando precedente consente di visualizzare l'elenco dei pool che si trovano nel sito Redmond. Per ottenere questo risultato, il comando recupera le informazioni complete del sito Redmond, quindi invia tramite pipe i dati al cmdlet Select-Object. A sua volta, il cmdlet Select-Object utilizza il parametro ExpandProperty per "espandere" il valore della proprietà Pools. L'espansione del valore di una proprietà significa che tutti i valori memorizzati in quella proprietà verranno visualizzati sullo schermo con una disposizione di facile lettura.