Import-AzurePublishSettingsFile
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
Default (Standardwert)
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Parametereigenschaften
| Typ: | AzureSMProfile |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PublishSettingsFile
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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.