Set-CsSite
Ultima modifica dell'argomento: 2012-03-26
Modifica le proprietà di uno qualsiasi dei siti di Microsoft Lync Server 2010. Tali siti rappresentano una raccolta di pool Lync Server 2010 e sono generalmente dislocati in diverse aree geografiche. Lync Server include due tipi di siti: siti di data center e siti remoti (succursali).
Sintassi
Set-CsSite [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-FederationRoute <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Con Lync Server 2010 viene introdotto un nuovo concetto nella topologia di Lync Server: i siti. I siti, da non confondere con i siti Active Directory o Microsoft Exchange Server, sono una raccolta di pool e server Lync Server generalmente organizzati in base all'area geografica e alla larghezza di banda della rete. Ad esempio, se tutti i computer di Redmond sono collocati nella stessa rete LAN con connessioni a bassa latenza ed elevata velocità, è possibile designare un sito di Redmond che includa quei computer. Se i computer di Dublino sono collocati in una specifica rete LAN e condividono connessioni a bassa latenza ed elevata velocità, è possibile anche un sito di Dublino separato. I siti svolgono inoltre un ruolo fondamentale nella gestione di Lync Server, poiché molti criteri e impostazioni possono essere configurati nell'ambito del sito, semplificando operazioni quali l'applicazione di un set di dial plan agli utenti di Redmond e di un set diverso di dial plan agli utenti di Dublino.
I siti vengono creati utilizzando lo Generatore di topologie ed eventuali modifiche all'infrastruttura del sito, come l'aggiunta di nuovi pool, devono essere apportate mediante questo strumento. È tuttavia possibile utilizzare il cmdlet Set-CsSite per modificare il nome visualizzato, la descrizione e la route di federazione di qualsiasi sito dell'organizzazione.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Set-CsSite in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSite"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Nome del sito da modificare, ad esempio: -Identity "Redmond". Non utilizzare il formato "site:Redmond" per specificare l'identità. |
Description |
Facoltativo |
Stringa |
Consente agli amministratori di aggiungere ulteriori informazioni in un oggetto del sito. Ad esempio, Description può includere informazioni di contatto per il sito. |
DisplayName |
Facoltativo |
Stringa |
Nome descrittivo del sito. Ad esempio: -DisplayName "Nord America e Sud America". |
FederationRoute |
Facoltativo |
Stringa |
Posizione del servizio del Edge Server utilizzata per fornire un collegamento tra la rete interna e Internet. Ad esempio: -FederationRoute "EdgeServer:atl-edge-001.litwareinc.com". |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di prompt di conferma o messaggi di errore non irreversibile che possono verificarsi quando si esegue il cmdlet. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Nessuno. Set-CsSite non accetta input inviato tramite pipe.
Tipi restituiti
Set-CsSite non restituisce oggetti o valori. Modifica le istanze dell'oggetto Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsSite -Identity Redmond -Description "Full-time employees in Redmond, WA."
Con il comando mostrato nell'esempio 1 si modifica la proprietà Description per il sito di Redmond (-Identity Redmond).
-------------------------- Esempio 2 ------------------------
Set-CsSite -Identity Redmond -DisplayName "US Headquarters"
Con il comando precedente si modifica il valore del nome visualizzato per il sito di Redmond in "US Headquarters".
-------------------------- Esempio 3 ------------------------
Get-CsSite | Where-Object {$_.Description -eq $Null} | ForEach-Object {Set-CsSite $_.Identity -Description "Litwareinc.com"}
Con il comando mostrato nell'esempio 3 vengono individuati tutti i siti che non dispongono di una proprietà Description, quindi si assegna a ognuno di tali siti una descrizione generica "Litwareinc.com". Per questo scopo, viene chiamato prima Get-CsSite senza parametri per ottenere una raccolta di tutti i siti Lync Server. La raccolta restituita viene quindi inviata tramite pipe al cmdlet Where-Object, che preleva solo i siti con proprietà Description uguale a (-eq) un valore Null ($Null). Tali siti vengono quindi inviati tramite pipe al cmdlet ForEach-Object. Questo cmdlet sceglie ogni elemento della raccolta e utilizza Set-CsSite per modificare il valore della proprietà Description.