New-CsNetworkSite
Ultima modifica dell'argomento: 2012-03-27
Consente di creare un nuovo sito di rete per l'uso con Controllo di ammissione di chiamata (CAC) o per le chiamate di emergenza.
Sintassi
New-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkSite -NetworkRegionID <String> -NetworkSiteID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
I siti di rete sono gli uffici o le postazioni configurati in ogni regione di una distribuzione CAC o per le chiamate di emergenza. Questo cmdlet consente di creare un nuovo sito e facoltativamente di associarlo a una regione. Ad esempio, una regione di rete per il Nord America potrebbe essere associata a siti di rete come Chicago, Redmond e Vancouver. Deve essere creato un sito di rete Controllo di ammissione di chiamata per ogni sito nell'organizzazione, anche se tale sito non presenta limiti della larghezza di banda.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsNetworkSite in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkSite"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsGlobalRelativeIdentity |
Un identificatore univoco per il sito di rete appena creato. I siti vengono creati solo nell'ambito globale, quindi questo identificatore non deve specificare un ambito. Contiene invece una stringa univoca tra tutti i siti di rete nella distribuzione di Microsoft Lync Server 2010. |
NetworkRegionID |
Obbligatorio |
Stringa |
L'identità della regione di rete a cui è associato questo sito. Questo parametro deve contenere un valore se si desidera fornire un BypassID (manualmente o tramite la generazione automatica) o se la proprietà EnableBandwidthPolicyCheck della configurazione della rete è impostata su True. È possibile recuperare le impostazioni di configurazione della rete chiamando il cmdlet Get-CsNetworkConfiguration. |
NetworkSiteID |
Obbligatorio |
Stringa |
Questo valore è identico a Identity. Non è possibile specificare un valore sia per Identity sia per NetworkSiteID; il valore immesso per l'uno verrà automaticamente utilizzato anche per l'altro. |
BWPolicyProfileID |
Facoltativo |
Stringa |
L'identità del profilo dei criteri di larghezza di banda che definisce i limiti della larghezza di banda per questo sito. È possibile recuperare un elenco dei profili disponibili chiamando il cmdlet Get-CsNetworkBandwidthPolicyProfile. Se si specifica un valore per questo parametro, è necessario specificare anche un valore per il parametro NetworkRegionID. |
BypassID |
Facoltativo |
Stringa |
Identificatore univoco globale (GUID) Questo GUID è utilizzato per mappare i siti di rete alle impostazioni di bypass multimediale con una configurazione di rete CAC o E9-1-1. Utilizzare questo valore BypassID nella chiamata a New-CsNetworkMediaBypassConfiguration. Se non si specifica un valore per questo parametro, un valore verrà generato automaticamente, ma solo se si specifica un valore per il parametro NetworkRegionID. Se non si fornisce un parametro NetworkRegionID, non viene generato alcun BypassID. Non è nemmeno possibile fornire esplicitamente un valore per il parametro BypassID senza specificare anche un valore per il parametro NetworkRegionID. Se si specifica un valore in modo esplicito, il valore deve essere nel formato GUID (ad esempio, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). La generazione automatica è la scelta consigliata. Se si immette manualmente un valore, viene visualizzata una richiesta di conferma per verificare che l'utente non desideri la generazione automatica del valore. |
Description |
Facoltativo |
Stringa |
Una stringa che descrive il sito. Questo parametro può essere utilizzato per fornire una spiegazione dello scopo o della posizione del sito più descrittiva di quanto non possa essere espresso con il solo parametro Identity. |
LocationPolicy |
Facoltativo |
Stringa |
Nomi dei criteri percorso associati a questo sito. I criteri percorso assegnano specifiche impostazioni per le chiamate di emergenza al sito. È possibile recuperare un elenco dei criteri percorso chiamando il cmdlet Get-CsLocationPolicy. |
Force |
Facoltativo |
Parametro opzionale |
Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche. |
InMemory |
Facoltativo |
Parametro opzionale |
Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente. |
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.
Tipi restituiti
Crea un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Esempio
-------------------------- Esempio 1 --------------------------
New-CsNetworkSite -Identity Vancouver -NetworkRegionID NorthAmerica
Con questo esempio viene creato un nuovo sito di rete denominato Vancouver. Il nome del sito viene specificato come valore del parametro Identity. Viene inoltre specificato un valore per il parametro NetworkRegionID, che in questo esempio associa il sito alla regione NorthAmerica. Il valore BypassID sarà generato automaticamente. Non è consigliabile impostare manualmente un valore per BypassID.
Il comando in questo esempio non è incluso il parametro BWPolicyProfileID. Se non viene aggiunto successivamente un valore con Set-CsNetworkSite, questo sito non presenterà limitazioni della larghezza di banda per le connessioni multimediali.
-------------------------- Esempio 2 --------------------------
New-CsNetworkSite -Identity Paris -NetworkRegionID EMEA -BWPolicyProfileID LowBWLimits
Con l'esempio 2 viene creato un nuovo sito di rete denominato Paris. Il nome del sito viene specificato come valore del parametro Identity. Come nell'esempio 1 viene specificato anche un valore per NetworkRegionID, questa volta corrispondente alla regione EMEA. Ancora una volta viene seguito il percorso consigliato, permettendo al cmdlet di generare il BypassID. A differenza dell'esempio 1, con questo esempio viene specificato anche un valore per il parametro BWPolicyProfileID: LowBWLimits. Per questo sito saranno utilizzati i criteri associati a tale profilo.