Condividi tramite

  • Articolo

New-CsNetworkSubnet

 

Ultima modifica dell'argomento: 2012-03-27

Consente di creare una nuova subnet.

Sintassi

New-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> -MaskBits <Int32> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkSubnet -MaskBits <Int32> -SubnetID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Ciascuna subnet deve essere associata ad un sito di rete per stabilire la località geografica dell'host che appartiene a questa subnet. Utilizzando questo cmdlet, è possibile creare una nuova subnet e (facoltativamente) assegnarla contemporaneamente a un nuovo sito di rete.

Nella maggior parte delle distribuzioni di Microsoft Lync Server 2010 che implementano il servizio Controllo di ammissione di chiamata (CAC), generalmente sarà presente un numero elevato di subnet. Di conseguenza, spesso è consigliabile utilizzare il cmdlet New-CsNetworkSubnet insieme al cmdlet di Windows PowerShellImport-CSV. L'abbinamento di questi due cmdlet consente di leggere le impostazioni delle subnet da un file CSV e di creare più subnet contemporaneamente. Per ulteriori informazioni, vedere la sezione Esempi per questo cmdlet.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsNetworkSubnet 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 "New-CsNetworkSubnet"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

L'ID univoco della subnet da creare. Questo valore deve essere il primo indirizzo IP (ad esempio, 174.11.12.0) nell'intervallo di indirizzi IP definito dalla subnet.

MaskBits

Obbligatorio

Int32

La maschera di bit da applicare alla subnet da creare.

Valori validi: Da 1 a 32

SubnetID

Obbligatorio

Stringa

Questo valore è uguale all'identità. È necessario specificare un'identità o un ID della subnet (SubnetID), ma non è possibile specificarli entrambi. Il valore fornito per un parametro verrà automaticamente applicato anche all'altro.

Description

Facoltativo

Stringa

Una descrizione della subnet da creare.

NetworkSiteID

Facoltativo

Stringa

L'ID del sito a cui appartiene la subnet. È possibile ottenere gli ID dei siti per la propria distribuzione utilizzando il cmdlet Get-CsNetworkSite.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.

Esempio

-------------------------- Esempio 1 --------------------------

New-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 24 -NetworkSiteID Vancouver

Questo esempio dimostra come creare un nuovo oggetto subnet che rappresenta la subnet 172.11.15.0/24. L'identità della subnet è impostata su 172.11.15.0. Questo valore verrà automaticamente assegnato anche al parametro SubnetID. È necessario definire una maschera di bit per la subnet. Per ottenere questo risultato, si specifica un valore (in questo caso 24) per il parametro MaskBits. Infine, per il parametro NetworkSiteID viene specificato l'ID sito Vancouver in modo da associare la subnet a questo sito.

-------------------------- Esempio 2 --------------------------

Import-CSV C:\subnet.csv | foreach {New-CsNetworkSubnet -Identity $_.Identity -MaskBits $_.Mask -NetworkSiteID $_.SiteID}

Nell'Esempio 2 si leggono i dati da un file CSV per creare una serie di subnet. Il file CSV in questo esempio sarà simile al seguente:

Identity, Mask, SiteID

172.11.12.0, 24, Redmond

172.11.13.0, 24, Chicago

172.11.14.0, 25, Vancouver

172.11.15.0, 31, Paris

...

Nell'esempio, si inizia utilizzando il cmdlet Import-CSV e specificando il percorso di un file CSV. Il cmdlet legge e memorizza il contenuto del file. Questi contenuti vengono poi inviati tramite pipe alla funzione Foreach. La funzione Foreach esamina il contenuto una riga alla volta. Come risulta evidente dal file di esempio, la prima riga è un elenco di intestazioni che definiscono il resto del contenuto; la funzione Foreach utilizza queste intestazioni per accedere ai file CSV per nome.

Nell'istruzione Foreach, viene utilizzato il cmdlet New-CsNetworkSubnet. Mentre la funzione Foreach esamina tutte le singole righe del contenuto del file, la riga in questione viene specificata come valore per i parametri di New-CsNetworkSubnet. Ad esempio, la prima volta che esamina l'istruzione Foreach, il cmdlet New-CsNetworkSubnet crea una subnet con Identity 172.11.12.0: questo è il valore del parametro Identity nella prima riga di valori CSV. Il simbolo $_ indica il valore corrente nel ciclo Foreach. Viene quindi importato dal file il valore della maschera (24) per il parametro MaskBits e il valore dell'ID sito (Redmond) per il parametro NetworkSiteID.

Questo processo prosegue fino a quando non sono state lette tutte le righe del file e i loro valori non sono stati utilizzati per creare nuove subnet.