Import-CsLisConfiguration
Dernière rubrique modifiée : 2012-03-23
Importe une configuration Enhanced 9-1-1 (E9-1-1) Enterprise Voice à partir d’un fichier de sauvegarde.
Syntaxe
Import-CsLisConfiguration -FileName <String>
Import-CsLisConfiguration -ByteInput <Byte[]>
Description détaillée
En fonction de la taille de l’organisation, mettre en œuvre E9-1-1 peut entraîner un mappage de milliers de sous-réseaux, ports, commutateurs et points d’accès sans fil à des emplacements. Une configuration E9-1-1 inclut également des informations sur le serveur LIS (Location Information Server) fournis par le fournisseur de réseau E9-1-1, sur les emplacements, sur les adresses civiles, ainsi que des informations indiquant s’ils ont été validés ou pas. Étant donné le volume d’informations et les paramètres requis pour mettre en œuvre le système E9-1-1, il est fortement recommandé de sauvegarder régulièrement la configuration entière. Vous pouvez sauvegarder la configuration E9-1-1 entière dans un fichier en appelant la cmdlet Export-CsLisConfiguration. L’appel de Import-CsLisConfiguration restaurera la configuration à partir de ce fichier.
Restaurer la configuration en appelant la cmdlet n’effacera pas la configuration existante. Cela permettra plutôt d’insérer l’information qui a été supprimée, mais ne supprimera pas les enregistrements existants ajoutés après la création du fichier de sauvegarde.
IMPORTANT : Le fait que l’importation qui suit la sauvegarde ne remplace pas les enregistrements existants signifie que tout enregistrement modifié sera restauré. Vous pourrez ainsi avoir des emplacements orphelins. Par exemple, supposons que vous ayez défini un point d’accès sans fil (WAP) avec une valeur d’emplacement de Building30/Room10. Vous appelez Export-CsLisConfiguration pour sauvegarder votre configuration. Plus tard, vous modifiez la propriété de l’emplacement de ce point d’accès sans fil à Building30/Rooms20-40. Si vous appelez ensuite Import-CsLisConfiguration pour restaurer la configuration sauvegardée, l’emplacement de ce WAP sera Building30/Room10 (emplacement avant la sauvegarde), mais l’emplacement de Building30/Rooms20-40 restera dans la base de données de configuration des emplacements.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Import-CsLisConfiguration : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsLisConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
ByteInput |
Obligatoire |
Octet[] |
La valeur affectée à ce paramètre est une variable qui contient une classe d’octets de la configuration LIS créée par la cmdlet Export-CsLisConfiguration avec le paramètre AsBytes. |
FileName |
Obligatoire |
Chaîne |
Le nom du fichier de sauvegarde à partir duquel il faut importer la configuration. Vous ne pouvez pas spécifier le paramètre FileName et ByteInput. Seul un des ces paramètres peut être utilisé pour chaque appel à cette cmdlet. |
Types d’entrées
Byte[]. Accepte un tableau d’octets d’une configuration LIS exportée. Le tableau d’octets doit être redirigé en tant qu’enregistrement unique. Voir l’exemple 3.
Types de retours
Cette cmdlet ne renvoie aucune valeur.
Exemple
-------------------------- Exemple 1 --------------------------
Import-CsLisConfiguration -FileName C:\E911Config.bak
Cet exemple importe la configuration E9-1-1 depuis le fichier de sauvegarde nommé E911Config.back vers la base de données de configuration des emplacements.
-------------------------- Exemple 2 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
Import-CsLisConfiguration -ByteInput $lisconfig
L’exemple 2 montre comment utiliser le paramètre ByteInput de la cmdlet Import-CsLisConfiguration. La ligne 1 affiche l’appel à la cmdlet Export-CsLisConfiguration avec le paramètre AsBytes. Le résultat de la commande est une classe d’octets contenant la configuration LIS. La classe est assignée à une variable $lisconfig. Dans la ligne 2, la cmdlet Import-CsLisConfiguration est appelée. Le paramètre ByteInput reçoit une valeur de $lisconfig, qui est la variable contenant la classe d’octets que nous exportons. Vous importerez ainsi de nouveau le tableau d’octets vers la base de données de configuration des emplacements.
-------------------------- Exemple 3 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
$listconfig | Set-Content -Path C:\E911Config.bak -Encoding byte
Get-Content -ReadCount 0 -Encoding byte -Path C:\E911Config.bak | Import-CsLisConfiguration
La version de l’exemple 3 est plus complète que celle de l’exemple 2. La première ligne est la même : nous appelons Export-CsLisConfiguration avec le paramètre AsBytes pour enregistrer la configuration LIS en tant que tableau d’octets dans la variable $lisconfig. Le reste de l’exemple montre comment enregistrer cette configuration vers un fichier et ensuite l’importer à nouveau dans la base de données de configuration des emplacements.
Dans la ligne 2, nous acheminons le contenu de $lisconfig, qui est le tableau d’octets représentant la configuration LIS, vers la cmdlet Set-Content de Windows PowerShell. Nous affectons des valeurs à deux paramètres de Set-Content : Path et Encoding. Nous assignons le chemin entier et le nom du fichier où nous voulons enregistrer la configuration vers le paramètre Path. Nous utilisons le paramètre Encoding avec une valeur d’octet pour nous assurer que la configuration est enregistrée comme classe d’octets.
Enfin, à la ligne 3, nous importons la configuration à nouveau dans la base de données de configuration des emplacements. Nous appelons d’abord Get-Content pour récupérer le contenu du fichier. Nous transférons une valeur de 0 à la propriété ReadCount qui instruit Get-Content de lire tout le contenu du fichier en une seule fois, plutôt qu’une ligne à la fois. Nous utilisons à nouveau le paramètre Encoding avec une valeur d’octet pour spécifier quel type de données nous lisons à partir du fichier. Enfin, nous transférons le nom de fichier au paramètre Path. Le contenu du fichier lu avec Get-Content est redirigé vers la cmdlet Import-CsLisConfiguration qui importe la configuration enregistrée dans la base de données de configuration des emplacements.
Voir aussi
Autres ressources
Export-CsLisConfiguration
Publish-CsLisConfiguration
Unpublish-CsLisConfiguration
Debug-CsLisConfiguration
Test-CsLisConfiguration