New-CsNetworkBWAlternatePath
Ultima modifica dell'argomento: 2012-03-26
Crea nuove impostazioni che definiscono se i segnali multimediali possono essere instradati a percorsi alternativi tramite Internet per le connessioni con larghezza di banda limitata.
Sintassi
New-CsNetworkBWAlternatePath -AlternatePath <$true | $false> -BWPolicyModality <Audio | Video>
Descrizione dettagliata
In una configurazione del servizio Controllo di ammissione di chiamata in Microsoft Lync Server 2010 sono disponibili due modalità: audio e video. È possibile impostare limitazioni della larghezza di banda per ciascuna di queste modalità. Se le limitazioni di larghezza di banda impediscono il completamento di una chiamata, è possibile che tale chiamata venga instradata a un percorso alternativo tramite Internet, rendendo stabile la connessione della chiamata. Questo cmdlet consente di creare le impostazioni che definiscono se una chiamata può essere instradata a un percorso alternativo tramite Internet in base alla modalità. All'interno della configurazione Controllo di ammissione di chiamata queste impostazioni sono valide per area.
Questo cmdlet non salva immediatamente le impostazioni appena create. Al contrario, crea le impostazioni in memoria. Affinché tali impostazioni vengano applicate a un'area della rete, è necessario assegnare l'output del cmdlet a una variabile e quindi utilizzare la variabile come valore per il parametro BWAlternatePaths del cmdlet New-CsNetworkRegion o Set-CsNetworkRegion. Si noti che è possibile applicare queste impostazioni in modo diretto tramite l'utilizzo dei parametri AudioAlternatePath e VideoAlternatePath relativi ai cmdlet New-CsNetworkRegion e Set-CsNetworkRegion, senza dover prima chiamare New-CsNetworkBWAlternatePath per creare un nuovo oggetto.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsNetworkBWAlternatePath i membri dei seguenti gruppi: RTCUniversalServerAdmins. 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 "New-CsNetworkBWAlternatePath"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
AlternatePath |
Obbligatorio |
Booleano |
Impostare il parametro su True per consentire alle chiamate effettuate dal supporto multimediale della modalità specificata nel parametro BWPolicyModality (audio o video) di essere instradate a un percorso alternativo se nel percorso principale non è disponibile una larghezza di banda adeguata. |
BWPolicyModality |
Obbligatorio |
BWPolicyModality |
La modalità a cui viene applicata l'impostazione del percorso alternativo. Valori validi: audio, video Tipo di dati completi: Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyModality |
Tipi di input
Nessuno.
Tipi restituiti
Consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWAlternatePathType.
Esempio
-------------------------- Esempio 1 --------------------------
$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $true
New-CsNetworkRegion -Identity NorthAmerica -CentralSite Redmond-NA-MLS -BWAlternatePaths $a
In questo esempio viene creato un nuovo percorso alternativo per la larghezza di banda della rete e le impostazioni vengono assegnate a un'area appena creata. Nella prima riga dell'esempio viene chiamato il cmdlet New-CsNetworkBWAlternatePath per creare un nuovo percorso alternativo. Un percorso alternativo dispone solo di due proprietà: BWPolicyModality che deve essere impostata su audio o video (audio in questo esempio) e AlternatePath che deve essere impostata su True o False (True in questo esempio). L'output del cmdlet, un riferimento all'oggetto percorso alternativo appena creato, viene assegnato alla variabile $a.
Nella riga 2 dell'esempio il percorso alternativo appena creato viene utilizzato per la creazione di una nuova area di rete. A tale scopo, viene chiamato New-CsNetworkRegion con Identity NorthAmerica. Viene assegnato un valore al parametro obbligatorio CentralSite (nell'esempio il nome del sito centrale per quest'area è Redmond-NA-MCS), quindi viene specificato il parametro BWAlternatePaths, a cui viene passata la variabile ($a) contenente l'oggetto percorso alternativo appena creato.