Partager via

  • Article

Export-CsLisConfiguration

 

Dernière rubrique modifiée : 2012-03-23

Exporte une configuration Enhanced 9-1-1 (E9-1-1) Enterprise Voice vers un fichier au format compressé pour des besoins de sauvegarde.

Syntaxe

Export-CsLisConfiguration -FileName <String>

Export-CsLisConfiguration [-AsBytes <SwitchParameter>]

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 les services Web fournis par le fournisseur de réseau E9-1-1, les emplacements ainsi que les adresses civiles et 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 E9-1-1, il est recommandé de sauvegarder régulièrement la configuration entière. Vous pouvez utiliser cette cmdlet pour sauvegarder la configuration E9-1-1 vers un fichier dont la configuration entière est enregistrée au format compressé. Pour récupérer la configuration, appelez la cmdlet Import-CsLisConfiguration.

Cette cmdlet crée un nouveau fichier de sauvegarde ; elle n’écrase pas un fichier existant. Cela signifie que le nom de fichier spécifié dans l’appel à la cmdlet ne peut pas être le nom du fichier existant.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Export-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 "Export-CsLisConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

FileName

Obligatoire

Chaîne

Le nom du chemin et du fichier vers lequel vous voulez sauvegarder la configuration. Cela ne peut pas être le nom du fichier existant.

Si vous fournissez une valeur au paramètre AsByte, vous ne pouvez pas en fournir une au paramètre FileName. Si vous accédez à cette cmdlet, vous devez utiliser AsBytes plutôt que le nom de fichier.

AsBytes

Facultatif

Paramètre de commutateur

Retourne la configuration comme classe d’octets. Le résultat de la commande doit être assigné à une variable pour importation ultérieure. (Si vous n’affectez pas le résultat à une variable, le tableau d’octets représentant la configuration fera défiler votre fenêtre Lync Server Management Shell.) Vous ne pouvez pas spécifier à la fois les paramètres AsBytes et FileName. Vous ne pouvez qu’utiliser l’un ou l’autre chaque fois que vous appelez cette cmdlet.

Types d’entrées

Aucun.

Types de retours

Retourne un tableau d’octets (Byte[]) quand c’est le paramètre AsBytes qui est utilisé.

Exemple

-------------------------- Exemple 1 --------------------------

Export-CsLisConfiguration -FileName C:\E911Config.bak

Cet exemple exporte toute la configuration E9-1-1 du serveur LIS (Location Information Server) vers le fichier de sauvegarde appelé E911Config.bak.

-------------------------- Exemple 2 --------------------------

$lisconfig = Export-CsLisConfiguration -AsBytes

Dans cet exemple, la configuration LIS est enregistrée comme classe d’octets dans la variable $lisconfig.

-------------------------- Exemple 3 --------------------------

$lisconfig = Export-CsLisConfiguration -AsBytes
$lisconfig | 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 sera lu à 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 des emplacements.