Import-AzurePublishSettingsFile

  • Référence
Module:
Azure

Importe un fichier de paramètres de publication qui vous permet de gérer vos comptes Azure dans Windows PowerShell.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

Import-AzurePublishSettingsFile
      -PublishSettingsFile <String>
      [-Environment <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

L’applet de commande Import-AzurePublishSettingsFile importe un fichier de paramètres de publication (*.publishsettings) qui contient des informations sur vos comptes Azure et enregistre un fichier de données d’abonnement sur votre ordinateur. Une fois l’applet de commande terminée, vous pouvez gérer vos comptes Azure dans Windows PowerShell.

Avant d’exécuter Import-AzurePublishSettingsFile, exécutez Get-AzurePublishSettingsFile, qui télécharge et enregistre le fichier de paramètres de publication pour pouvoir l’importer.

Pour rendre votre compte Azure disponible pour Windows PowerShell, vous pouvez utiliser un fichier de paramètres de publication ou l’applet de commande Add-AzureAccount . Les fichiers de paramètres de publication vous permettent de préparer la session à l’avance afin de pouvoir exécuter des scripts et des travaux en arrière-plan sans assistance. Toutefois, tous les services ne prennent pas en charge les fichiers de paramètres de publication. Par exemple, le module AzureResourceManager ne prend pas en charge les fichiers de paramètres de publication.

Remarque de sécurité : Les fichiers de paramètres de publication contiennent un certificat de gestion encodé, mais pas chiffré. Si des utilisateurs malveillants accèdent à votre fichier de paramètres de publication, ils peuvent modifier, créer et supprimer vos services Azure. En guise de bonne pratique de sécurité, enregistrez le fichier à un emplacement dans votre dossier Téléchargements ou Documents, puis supprimez-le après l’utilisation de l’applet de commande Import-AzurePublishSettingsFile pour importer les paramètres.

Exemples

Exemple 1 : Importer un fichier

PS C:\> Import-AzurePublishSettingsFile -PublishSettingsFile C:\Temp\MyAccount.publishsettings

Cette commande importe le fichier « C:\Temp\MyAccount.publishsettings ».

Paramètres

-Environment

Spécifie un environnement Azure.

Un environnement Azure un déploiement indépendant de Microsoft Azure, tel qu’AzureCloud pour Azure global et AzureChinaCloud pour Azure géré par 21Vianet en Chine. Vous pouvez également créer des environnements Azure locaux à l’aide d’Azure Pack et des applets de commande WAPack. Pour plus d’informations, consultez Azure Pack.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishSettingsFile

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

None

Vous pouvez diriger l’entrée vers cette applet de commande par nom de propriété, mais pas par valeur.

Sorties

None

Cette applet de commande ne génère aucune sortie.

Notes

  • Un « fichier de paramètres de publication » est un fichier XML avec une extension de nom de fichier .publishsettings. Le fichier contient un certificat encodé qui fournit des informations d’identification de gestion pour vos abonnements Azure. Après avoir importé ce fichier, supprimez-le pour éviter les risques de sécurité.
  • Un « fichier de données d’abonnement » est un fichier XML qui peut être enregistré sur votre ordinateur en toute sécurité. Par défaut, il est enregistré dans votre profil utilisateur itinérant ($home/AppData/Roaming).