Partager via

Get-AzurePublishSettingsFile

  • Référence
Module:
Azure

Télécharge le fichier de paramètres de publication d’un abonnement Azure.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Get-AzurePublishSettingsFile
   [-Environment <String>]
   [-Realm <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzurePublishSettingsFile télécharge un fichier de paramètres de publication pour un abonnement dans votre compte. Une fois la commande terminée, vous pouvez utiliser l’applet de commande Import-PublishSettingsFile pour rendre les paramètres dans le fichier disponibles pour Windows PowerShell.

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.

Lorsque vous exécutez Get-AzurePublishSettingsFile, il ouvre votre navigateur par défaut et vous invite à vous connecter à votre compte Azure, à sélectionner un abonnement et à sélectionner un emplacement de système de fichiers pour le fichier de paramètres de publication. Ensuite, il télécharge le fichier de paramètres de publication de votre abonnement dans le fichier que vous avez sélectionné.

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.

Remarque de sécurité : Les fichiers de paramètres de publication contiennent des informations d’identification utilisées pour administrer vos abonnements et services Azure. 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.

Cette rubrique décrit l’applet de commande dans la version 0.8.10 du module Microsoft Azure PowerShell. Pour obtenir la version du module que vous utilisez, dans la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

Exemples

Exemple 1 : Télécharger un fichier de paramètres de publication

PS C:\> Get-AzurePublishSettingsFile

Cette commande ouvre votre navigateur par défaut, se connecte à votre compte Windows Azure, puis télécharge le fichier .publishsettings pour votre compte.

Exemple 2 : Spécifier un domaine

PS C:\> Get-AzurePublishSettingsFile -Realm contoso.com -Passthru

Cette commande télécharge le fichier de paramètres de publication d’un compte dans le domaine contoso.com. Utilisez une commande avec le paramètre Realm lorsque vous vous connectez à Azure avec un compte d’organisation, au lieu d’un compte Microsoft.

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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Retourne $True si la commande réussit et $False en cas d’échec. Par défaut, cette applet de commande ne retourne aucune sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Realm

Spécifie l’organisation dans un ID d’organisation. Par exemple, si vous vous connectez à Azure en tant que admin@contoso.com, la valeur du paramètre Realm est contoso.com. Utilisez ce paramètre lorsque vous utilisez un ID d’organisation pour vous connecter au Portail Azure. Ce paramètre n’est pas obligatoire lorsque vous utilisez un compte Microsoft, tel qu’un outlook.com ou un compte live.com.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 or System.Boolean

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne une valeur booléenne. Sinon, cette applet de commande ne retourne aucune sortie