Import-CsConfiguration
Ultima modifica dell'argomento: 2012-03-23
Consente di importare la topologia, i criteri e le impostazioni di configurazione di Microsoft Lync Server 2010 in archivio di gestione centrale o sul computer locale.
Sintassi
Import-CsConfiguration -ByteInput <Byte[]> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Import-CsConfiguration -FileName <String> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
I computer che eseguono i servizi di Lync Server 2010 o i ruoli di server devono avere una copia della topologia corrente, una copia delle impostazioni di configurazione correnti, una copia dei criteri correnti e così via prima che possano funzionare nel ruolo assegnato. Lync Server è responsabile di garantire che queste informazioni vengano fornite a tutti i computer che le richiedono.
I cmdlet Import-CsConfiguration e Export-CsConfiguration vengono utilizzati per il backup e il ripristino della topologia, delle impostazioni di configurazione e dei criteri di Lync Server durante un aggiornamento di archivio di gestione centrale. Il cmdlet Export-CsConfiguration consente di esportare dati in un file ZIP; è possibile quindi utilizzare il cmdlet Import-CsConfiguration per leggere quel file ZIP e ripristinare la topologia, le impostazioni di configurazione e i criteri in archivio di gestione centrale. Dopo di che, i servizi di replica di Lync Server replicheranno le informazioni ripristinate sui computer sui quali sono in esecuzione i servizi.
La possibilità di esportare e importare dati di configurazione viene anche utilizzata nella configurazione iniziale di computer che si trovano nella rete perimetrale (ad esempio, Edge Server). Quando si configura un computer che si trova nella rete perimetrale, è necessario prima eseguire una replica manuale utilizzando i cmdlet CsConfiguration: sarà necessario esportare i dati di configurazione utilizzando Export-CsConfiguration e poi copiare il file ZIP sul computer nella rete perimetrale. Sarà quindi possibile utilizzare Import-CsConfiguration ed il parametro LocalStore per importare i dati. È necessario effettuare questa operazione solo una volta dopo di che la replica avviene automaticamente.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Import-CsConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Oltre a essere un membro di RTCUniversalServerAdmins, per poter eseguire questo cmdlet è altresì necessario essere un amministratore locale oppure avere le autorizzazioni di replicatore della configurazione locale. 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 "Import-CsConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
ByteInput |
Facoltativo |
Matrice di byte |
Legge le informazioni della topologia da una matrice di byte memorizzata in una variabile. Questa matrice di byte viene creata utilizzando il parametro ByteInput quando si utilizza il cmdlet Export-CsConfiguration. Non è possibile utilizzare i parametri ByteInput e FileName nello stesso comando. |
FileName |
Facoltativo |
Stringa |
Percorso per il file .ZIP creato da Export-CsConfiguration. Ad esempio: -FileName "C:\Config.zip". Si noti che è necessario includere il parametro FileName o ByteInput, ma non entrambi, quando si utilizza il cmdlet Import-CsConfiguration. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione delle richieste che altrimenti verrebbero visualizzate in caso di errore non grave durante l'esecuzione del comando. Per impostare il parametro Force su True, utilizzare la seguente sintassi: -Force:$True |
LocalStore |
Facoltativo |
Parametro opzionale |
Consente di copiare i dati di configurazione sul computer locale invece che in archivio di gestione centrale. |
Tipi di input
Nessuno. Import-CsConfiguration non accetta input tramite pipeline.
Tipi restituiti
Import-CsConfiguration non restituisce alcun oggetto o valore.
Esempio
-------------------------- Esempio 1 --------------------------
Import-CsConfiguration -FileName "C:\Config.zip"
Il comando precedente consente di importare la topologia, le impostazioni di configurazione e i criteri correnti da un file denominato C:\Config.zip in archivio di gestione centrale.
-------------------------- Esempio 2 --------------------------
Import-CsConfiguration -FileName "C:\Config.zip" -LocalStore
L'Esempio 2 illustra il modo in cui è possibile replicare inizialmente i dati su un computer locale che si trova nella rete perimetrale. In questo esempio, i dati di configurazione sono stati esportati in un file denominato Config.zip; questo file è stato quindi copiato nella cartella C:\ sul computer che si trova nella rete perimetrale. Viene quindi utilizzato il cmdlet Import-CsConfiguration per importare quei dati, specificando il parametro LocalStore per fare in modo che i dati siano importati sul computer locale invece che in archivio di gestione centrale.
-------------------------- Esempio 3 ------------------------
$x = Export-CsConfiguration -AsBytes
Import-CsConfiguration -ByteInput $x -LocalStore
I due comandi riportati nell'Esempio 3 consentono di esportare la topologia, le impostazioni di configurazione e i criteri correnti e quindi di importarli sul computer locale senza dover utilizzare un file ZIP. Per ottenere questo risultato, il primo comando utilizza Export-CsConfiguration e il parametro AsBytes per esportare la topologia, le impostazioni di configurazione e i criteri correnti sotto forma di matrice di byte; questa matrice di byte viene memorizzata in una variabile denominata $x. Nel secondo comando, vengono utilizzati il cmdlet Import-CsConfiguration e il parametro ByteInput per importare le informazioni memorizzate nella variabile $x. Il parametro LocalStore fa in modo che i dati siano importati sul computer locale invece che in archivio di gestione centrale. L'effetto è che i dati vengono copiati da archivio di gestione centrale al computer locale.