Freigeben über

Get-AzurePublishSettingsFile

  • Referenz
Modul:
Azure

Lädt die Veröffentlichungseinstellungsdatei für ein Azure-Abonnement herunter.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet Get-AzurePublishSettingsFile lädt eine Veröffentlichungseinstellungsdatei für ein Abonnement in Ihrem Konto herunter. Nach Abschluss des Befehls können Sie das Cmdlet Import-PublishSettingsFile verwenden, um die Einstellungen in der Datei für Windows PowerShell verfügbar zu machen.

Um Ihr Azure-Konto für Windows PowerShell verfügbar zu machen, können Sie eine Veröffentlichungseinstellungsdatei oder das Add-AzureAccount-Cmdlet verwenden. Mit den Veröffentlichungseinstellungen können Sie die Sitzung im Voraus vorbereiten, sodass Sie Skripts und Hintergrundaufträge unbeaufsichtigt ausführen können. Nicht alle Dienste unterstützen jedoch die Veröffentlichung von Einstellungsdateien. Das AzureResourceManager-Modul unterstützt beispielsweise keine Veröffentlichungseinstellungendateien.

Wenn Sie Get-AzurePublishSettingsFile ausführen, öffnet es Ihren Standardbrowser und fordert Sie auf, sich bei Ihrem Azure-Konto anzumelden, ein Abonnement auszuwählen und einen Dateisystemspeicherort für die Veröffentlichungseinstellungsdatei auszuwählen. Anschließend lädt sie die Veröffentlichungseinstellungsdatei für Ihr Abonnement in die von Ihnen ausgewählte Datei herunter.

Eine "Veröffentlichungseinstellungsdatei" ist eine XML-Datei mit der Dateinamenerweiterung ".publishsettings". Die Datei enthält ein codiertes Zertifikat, das Verwaltungsanmeldeinformationen für Ihre Azure-Abonnements bereitstellt.

Sicherheitshinweis: Veröffentlichungseinstellungsdateien enthalten Anmeldeinformationen, die zum Verwalten Ihrer Azure-Abonnements und -Dienste verwendet werden. Wenn böswillige Benutzer auf Ihre Veröffentlichungseinstellungsdatei zugreifen, können sie Ihre Azure-Dienste bearbeiten, erstellen und löschen. Als bewährte Methode für die Sicherheit speichern Sie die Datei an einem Speicherort in Ihrem Ordner "Downloads" oder "Dokumente", und löschen Sie sie dann nach verwendung des Cmdlets "Import-AzurePublishSettingsFile ", um die Einstellungen zu importieren.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Beispiele

Beispiel 1: Herunterladen einer Veröffentlichungseinstellungsdatei

PS C:\> Get-AzurePublishSettingsFile

Dieser Befehl öffnet Ihren Standardbrowser, stellt eine Verbindung mit Ihrem Windows Azure-Konto her und lädt dann die Publishsettings-Datei für Ihr Konto herunter.

Beispiel 2: Angeben eines Bereichs

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

Mit diesem Befehl wird die Veröffentlichungseinstellungsdatei für ein Konto in der domäne contoso.com heruntergeladen. Verwenden Sie einen Befehl mit dem Parameter "Realm ", wenn Sie sich bei Azure mit einem Organisationskonto anstelle eines Microsoft-Kontos anmelden.

Parameter

-Environment

Gibt eine Azure-Umgebung an.

Eine Azure-Umgebung eine unabhängige Bereitstellung von Microsoft Azure, z. B. AzureCloud für globale Azure und AzureChinaCloud für Azure, betrieben von 21Vianet in China. Sie können auch lokale Azure-Umgebungen mithilfe von Azure Pack und den WAPack-Cmdlets erstellen. Weitere Informationen finden Sie unter Azure Pack.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt $True zurück, wenn der Befehl erfolgreich ist, und $False, wenn er fehlschlägt. Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Realm

Gibt die Organisation in einer Organisations-ID an. Wenn Sie sich beispielsweise bei Azure als admin@contoso.comanmelden, wird der Wert des Bereichsparameters contoso.com. Verwenden Sie diesen Parameter, wenn Sie eine Organisations-ID verwenden, um sich beim Azure-Portal anzumelden. Dieser Parameter ist nicht erforderlich, wenn Sie ein Microsoft-Konto verwenden, z. B. ein outlook.com- oder live.com-Konto.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.

Ausgaben

None or System.Boolean

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet einen booleschen Wert zurück. Andernfalls gibt dieses Cmdlet keine Ausgabe zurück.