Freigeben über

Import-AzurePublishSettingsFile

  • Referenz
Modul:
Azure

Importiert eine Veröffentlichungseinstellungsdatei, mit der Sie Ihre Azure-Konten in Windows PowerShell verwalten können.

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

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

Beschreibung

Das Cmdlet Import-AzurePublishSettingsFile importiert eine Veröffentlichungseinstellungsdatei (*.publishsettings), die Informationen zu Ihren Azure-Konten enthält und eine Abonnementdatendatei auf Ihrem Computer speichert. Nach Abschluss des Cmdlets können Sie Ihre Azure-Konten in Windows PowerShell verwalten.

Führen Sie vor dem Ausführen von Import-AzurePublishSettingsFile Get-AzurePublishSettingsFile aus, das die Veröffentlichungseinstellungsdatei herunterlädt und speichert, damit Sie sie importieren können.

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.

Sicherheitshinweis: Veröffentlichungseinstellungsdateien enthalten ein Verwaltungszertifikat, das codiert, aber nicht verschlüsselt ist. Wenn böswillige Benutzer auf Ihre Veröffentlichungseinstellungsdatei zugreifen, können sie Ihre Azure-Dienste möglicherweise 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.

Beispiele

Beispiel 1: Importieren einer Datei

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

Mit diesem Befehl wird die Datei "C:\Temp\MyAccount.publishsettings" importiert.

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:False
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

-PublishSettingsFile

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

Eingaben

None

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

Ausgaben

None

Dieses Cmdlet generiert keine Ausgabe.

Hinweise

  • 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. Nachdem Sie diese Datei importiert haben, löschen Sie sie, um Sicherheitsrisiken zu vermeiden.
  • Eine "Abonnementdatendatei" ist eine XML-Datei, die sicher auf Ihrem Computer gespeichert werden kann. Standardmäßig wird es in Ihrem Roamingbenutzerprofil ($home/AppData/Roaming) gespeichert.