Get-CsPool
Ultima modifica dell'argomento: 2012-03-23
Restituisce le informazioni sui pool utilizzati nella distribuzione di Microsoft Lync Server 2010. I pool sono una raccolta di computer che si trovano in un sito e che eseguono lo stesso insieme di servizi di Lync Server 2010.
Sintassi
Get-CsPool [-Identity <XdsGlobalRelativeIdentity>] [-Site <String>]
Get-CsPool [-Filter <String>] [-Site <String>]
Descrizione dettagliata
In Lync Server 2010 un pool è costituito da uno o più computer dello stesso sito che eseguono lo stesso insieme di servizi. Se ad esempio nel sito Redmond vi è un solo server che esegue il servizio Mediation Server, si disporrà di un pool Mediation Server costituito da tale computer. Se invece nel sito Redmond vi sono due computer che eseguono il servizio Mediation Server, si disporrà di un pool Mediation Server costituito da due computer. Il numero di pool utilizzati nell'organizzazione dipende dal numero di server disponibili e dai diversi servizi eseguiti da tali server.
Il cmdlet Get-CsPool consente di recuperare informazioni su ogni pool in uso nell'organizzazione, incluse le informazioni sui servizi eseguiti in ciascuno di essi.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsPool i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsPool"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Stringa |
Nome di dominio completo (FQDN) del pool da restituire. Ad esempio: -Identity atl-cs-001.litwareinc.com. Se questo parametro non è presente, verranno restituiti tutti i pool presenti nell'organizzazione. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per specificare il valore Identity del pool (o dei pool) in questione. Ad esempio, con la sintassi seguente vengono restituiti tutti i pool il cui valore Identity termina con il valore stringa ".fabrikam.com": -Filter "*.fabrikam.com". Si noti che non è possibile utilizzare i parametri Filter e Identity nello stesso comando. |
Site |
Facoltativo |
Stringa |
Consente di restituire tutti i pool presenti nel sito specificato. È necessario fare riferimento al sito in questione mediante il relativo valore DisplayName (ad esempio, Redmond) anziché mediante il relativo valore Identity (ad esempio, site:Redmond). Ad esempio: -Site "Redmond". È possibile recuperare i nomi visualizzati dei siti eseguendo questo comando: Get-CsSite | Select-Object Identity, DisplayName |
Tipi di input
Nessuno. Get-CsPool non accetta l'input da pipeline.
Tipi restituiti
Get-CsPool restituisce istanze dell'oggetto Microsoft.Rtc.Management.Deploy.Internal.Cluster.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsPool
Il comando precedente restituisce tutti i pool presenti nella distribuzione di Lync Server.
-------------------------- Esempio 2 --------------------------
Get-CsPool | Select-Object -ExpandProperty Computers
Nell'esempio 2 vengono visualizzate informazioni dettagliate sui computer presenti in ciascun pool. A tale scopo, viene chiamato Get-CsPool, quindi i dati restituiti vengono inviati tramite pipe al cmdlet Select-Object. Il parametro ExpandProperty di Select-Object viene quindi utilizzato per espandere il valore della proprietà Computers. Tale proprietà è una matrice di oggetti che rappresentano i singoli computer del pool. Quando si espande la proprietà Computers, vengono visualizzate informazioni dettagliate su ciascun computer.
-------------------------- Esempio 3 --------------------------
Get-CsPool -Identity atl-cs-001.litwareinc.com
Nell'esempio precedente il parametro Identity viene utilizzato per limitare i dati restituiti al pool con identità atl-cs-001.litwareinc.com.
-------------------------- Esempio 4 --------------------------
Get-CsPool -Site "Redmond"
Con l'esempio 4 vengono restituiti tutti i pool presenti nel sito Redmond. A tale scopo, nel comando viene utilizzato il parametro Site. Il valore "Redmond" del parametro consente di limitare i dati restituiti ai pool la cui proprietà Site è uguale a Redmond.
-------------------------- Esempio 5 --------------------------
Get-CsPool | Where-Object {$_.Services.Count -eq 0}
Il comando mostrato nell'esempio 5 restituisce una raccolta di tutti i pool in cui non è installato alcun servizio Lync Server. Per eseguire questa attività, nel comando viene innanzitutto chiamato Get-CsPool senza alcun parametro per restituire una raccolta di tutti i pool attualmente in uso nell'organizzazione. Tale raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona tutti i pool in cui la proprietà Services.Count è uguale a 0. Il conteggio (Count) uguale a 0 indica che per il pool non sono configurati servizi Lync Server.