Import-CsConfiguration
Dernière rubrique modifiée : 2012-03-23
Importe votre topologie, vos stratégies et vos paramètres de configuration Microsoft Lync Server 2010 dans le magasin central de gestion ou sur l’ordinateur local.
Syntaxe
Import-CsConfiguration -ByteInput <Byte[]> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Import-CsConfiguration -FileName <String> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Description détaillée
Les ordinateurs qui exécutent des services ou des rôles serveur Lync Server 2010 doivent disposer entre autres d’une copie de la topologie, des stratégies et des paramètres de configuration actuels avant de pouvoir assumer le rôle qui leur a été attribué. Lync Server est responsable de la transmission de ces informations à chaque ordinateur qui en a besoin.
Les cmdlets Import-CsConfiguration et Export-CsConfiguration servent à sauvegarder et à restaurer votre topologie, vos stratégies et vos paramètres de configuration Lync Server pendant une mise à niveau du magasin central de gestion. La cmdlet Export-CsConfiguration vous permet d’exporter les données dans un fichier .ZIP. Vous pouvez ensuite utiliser la cmdlet Import-CsConfiguration pour lire ce fichier .ZIP et restaurer la topologie, les stratégies et les paramètres dans le magasin central de gestion. Ensuite, les services de réplication de Lync Server répliquent les informations restaurées sur les ordinateurs exécutant des services.
La possibilité d’exporter et d’importer les données de configuration est également utilisée lors de la configuration initiale des ordinateurs situés dans votre réseau de périmètre (par exemple, un serveur Edge). Lors de la configuration d’un ordinateur situé dans le réseau de périmètre, vous devez d’abord procéder à une réplication manuelle à l’aide des cmdlets CsConfiguration : vous devrez exporter les données de configuration au moyen de la cmdlet Export-CsConfiguration, puis les copier dans le fichier .ZIP sur l’ordinateur du réseau de périmètre. Ensuite, vous pourrez utiliser la cmdlet Import-CsConfiguration et le paramètre LocalStore pour importer les données. Cette opération ne nécessite qu’une seule exécution ; par la suite, la réplication s’effectuera automatiquement.
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-CsConfiguration : RTCUniversalServerAdmins. Pour pouvoir exécuter cette cmdlet, vous devez non seulement appartenir au groupe RTCUniversalServerAdmins, mais vous devez également être un administrateur local ou bénéficier localement des autorisations nécessaires pour la réplication de configurations. 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-CsConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
ByteInput |
Facultatif |
Tableau d’octets |
Lit les informations de topologie dans un tableau d’octets stocké dans une variable. Ce tableau d’octets est créé par l’utilisation du paramètre ByteInput lors de l’appel de la cmdlet Export-CsConfiguration. Vous ne pouvez pas utiliser les paramètres ByteInput et FileName dans une même commande. |
FileName |
Facultatif |
Chaîne |
Chemin d’accès au fichier .ZIP créé par la cmdlet Export-CsConfiguration. Par exemple : -FileName "C:\Config.zip". Notez que vous devez inclure soit le paramètre FileName, soit le paramètre ByteInput, mais pas les deux, lors de l’appel de la cmdlet Import-CsConfiguration. |
Force |
Facultatif |
Paramètre de commutateur |
Ignore toutes les invites susceptibles d’apparaître lors de l’exécution de la commande en cas de survenue d’une erreur récupérable. Pour définir le paramètre Force sur True, utilisez la syntaxe suivante : -Force:$True |
LocalStore |
Facultatif |
Paramètre de commutateur |
Copie les données de configuration sur l’ordinateur local et non sur le magasin central de gestion. |
Types d’entrées
Aucun. Import-CsConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Import-CsConfiguration ne retourne ni objet ni valeur.
Exemple
-------------------------- Exemple 1 ------------------------
Import-CsConfiguration -FileName "C:\Config.zip"
La commande ci-dessus importe la topologie, les stratégies et les paramètres de configuration actuels à partir d’un fichier C:\Config.zip vers le magasin central de gestion.
-------------------------- Exemple 2 ------------------------
Import-CsConfiguration -FileName "C:\Config.zip" -LocalStore
L’exemple 2 montre comment les données peuvent être initialement répliquées sur un ordinateur situé dans le réseau de périmètre. Dans cet exemple, les données de configuration sont exportées dans un fichier Config.zip. Ce fichier est ensuite copié dans le dossier C:\ de l’ordinateur situé dans le réseau de périmètre. La cmdlet Import-CsConfiguration permet ensuite d’importer ces données. Le paramètre LocalStore entraîne l’importation des données sur l’ordinateur local au lieu du magasin central de gestion.
-------------------------- Exemple 3 ------------------------
$x = Export-CsConfiguration -AsBytes
Import-CsConfiguration -ByteInput $x -LocalStore
Les deux commandes dévoilées dans l’exemple 3 exportent la topologie, les stratégies et les paramètres de configuration actuels, puis importent ces données sur l’ordinateur local sans recourir à un fichier .ZIP. Pour ce faire, la première commande utilise la cmdlet Export-CsConfiguration et le paramètre AsBytes pour exporter la topologie, les paramètres de configuration et les stratégies actuels sous la forme d’un tableau d’octets stocké dans une variable $x. Dans la deuxième commande, la cmdlet Import-CsConfiguration et le paramètre ByteInput servent à importer les informations stockées dans la variable $x. L’utilisation du paramètre LocalStore permet d’importer les données sur l’ordinateur local au lieu du magasin central de gestion. Résultat : les données sont copiées du magasin central de gestion vers l’ordinateur local.