Set-CsDirector
Ultima modifica dell'argomento: 2012-03-27
Consente di modificare le proprietà di uno o più Director. È possibile utilizzare i Director per autenticare le richieste degli utenti, ma non per ospitare gli account degli utenti.
Sintassi
Set-CsDirector [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Director autentica gli utenti e risponde alle richieste degli utenti senza ospitare realmente gli account utente. In genere, i Director vengono utilizzati per organizzazioni che consentono l'accesso esterno alla rete attraverso gli Edge Server. In questo tipo di scenario, i Director contribuiscono non solo ad alleggerire la pressione esercitata sui server di front end gestendo le richieste di autenticazione, ma anche a proteggere la rete interna da attacchi di tipo denial-of-service e da altro traffico dannoso. I Director sono utili anche quando più server di front end vengono distribuiti in un sito centralizzato. In questo caso, i Director ricevono tutte le richieste degli utenti e quindi le incanalano al pool di server appropriato. Ancora una volta, ciò consente di alleggerire al pressione esercitata sui server di front end.
Il cmdlet Set-CsDirector consente di modificare i valori delle proprietà dei Director attualmente in uso nella propria organizzazione. Ciò include la modifica di elementi quali Server di archiviazione o Edge Server associati a Director o la modifica della porta utilizzata per inviare e ricevere il traffico SIP.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsDirector può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. 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 "Set-CsDirector"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsIdentity |
Percorso di installazione del Director da modificare. Ad esempio: -Identity "Director:atl-cs-001.litwareinc.com". Si noti che è possibile non utilizzare il prefisso "Director" quando si specifica un Director. Ad esempio: -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Facoltativo |
Stringa |
Posizione del Server di archiviazione da associare con Director. Ad esempio: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
EdgeServer |
Facoltativo |
Stringa |
Posizione del Edge Server da associare con Director. Ad esempio: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com" |
MonitoringServer |
Facoltativo |
Stringa |
Posizione del Monitoring Server da associare con Director. Ad esempio: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
SipPort |
Facoltativo |
Numero intero |
La porta utilizzata per il traffico SIP (Session Initiation Protocol). |
SipHealthPort |
Facoltativo |
Numero intero |
Porta utilizzata per il monitoraggio dell'integrità del server. |
SipServerTcpPort |
Facoltativo |
Numero intero |
Porta di attesa SIP. Il valore predefinito è 5060. |
WebPort |
Facoltativo |
Numero intero |
La porta utilizzata per la comunicazione con servizi Web. |
WebServer |
Facoltativo |
Stringa |
Posizione del server servizi Web da associare con Director. Ad esempio: -WebServer "WebServer:atl-cs-001.litwareinc.com" |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
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-CsDirector non accetta input tramite pipeline.
Tipi restituiti
Set-CsDirector non restituisce alcun oggetto o valore. In realtà, il cmdlet consente di modificare le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.DisplayDirector.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsDirector -Identity "Director:atl-cs-001.litwareinc.com" -ArchivingServer "ArchivingServer:dublin-cs-001.litwareinc.com"
Il comando riportato nell'Esempio 1 consente di modificare Server di archiviazione associato con Director Director:atl-cs-001.litwareinc.com. In questo esempio, Server di archiviazione viene modificato in ArchivingServer:dublin-cs-001.litwareinc.com.
-------------------------- Esempio 2 --------------------------
Get-CsService -Director | ForEach-Object {Set-CsDirector -Identity $_.Identity -SipPort 5072}
Il comando precedente consente di modificare la porta SIP di tutti i Director attualmente in suo nella propria organizzazione. Per ottenere questo risultato, il comando utilizza prima Get-CsService e il parametro Director per ottenere una raccolta di tutti i Director dell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object. A sua volta ForEach-Object esegue Set-CsDirector per ogni sito nella raccolta, modificando il valore della proprietà SipPort in 5072.