Delen via

Import-AzurePublishSettingsFile

  • Referentie
Module:
Azure

Hiermee importeert u een publicatie-instellingenbestand waarmee u uw Azure-accounts in Windows PowerShell kunt beheren.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Description

De cmdlet Import-AzurePublishSettingsFile importeert een publicatie-instellingenbestand (*.publishsettings) dat informatie over uw Azure-accounts bevat en slaat een abonnementsgegevensbestand op uw computer op. Wanneer de cmdlet is voltooid, kunt u uw Azure-accounts beheren in Windows PowerShell.

Voordat u Import-AzurePublishSettingsFile uitvoert, voert u Get-AzurePublishSettingsFile uit, waarmee het bestand met publicatie-instellingen wordt gedownload en opgeslagen, zodat u het kunt importeren.

Als u uw Azure-account beschikbaar wilt maken voor Windows PowerShell, kunt u een publicatie-instellingenbestand of de cmdlet Add-AzureAccount gebruiken. Met publicatie-instellingenbestanden kunt u de sessie vooraf voorbereiden, zodat u scripts en achtergrondtaken zonder toezicht kunt uitvoeren. Niet alle services bieden echter ondersteuning voor het publiceren van instellingenbestanden. De module AzureResourceManager biedt bijvoorbeeld geen ondersteuning voor het publiceren van instellingenbestanden.

Beveiligingsnotitie: Publiceer instellingenbestanden bevatten een beheercertificaat dat is gecodeerd, maar niet versleuteld. Als kwaadwillende gebruikers toegang hebben tot uw bestand met publicatie-instellingen, kunnen ze uw Azure-services mogelijk bewerken, maken en verwijderen. Als best practice voor beveiliging slaat u het bestand op een locatie in de map Downloads of Documenten op en verwijdert u het bestand nadat u de cmdlet Import-AzurePublishSettingsFile hebt gebruikt om de instellingen te importeren.

Voorbeelden

Voorbeeld 1: Een bestand importeren

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

Met deze opdracht wordt het bestand C:\Temp\MyAccount.publishsettings geïmporteerd.

Parameters

-Environment

Hiermee geeft u een Azure-omgeving op.

Een Azure-omgeving een onafhankelijke implementatie van Microsoft Azure, zoals AzureCloud voor wereldwijde Azure en AzureChinaCloud voor Azure beheerd door 21Vianet in China. U kunt ook on-premises Azure-omgevingen maken met behulp van Azure Pack en de WAPack-cmdlets. Zie Azure Pack voor meer informatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublishSettingsFile

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

None

U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.

Uitvoerwaarden

None

Met deze cmdlet wordt geen uitvoer gegenereerd.

Notities

  • Een bestand met de publicatie-instellingen is een XML-bestand met de extensie .publishsettings. Het bestand bevat een gecodeerd certificaat dat beheerreferenties biedt voor uw Azure-abonnementen. Nadat u dit bestand hebt geïmporteerd, verwijdert u het om beveiligingsrisico's te voorkomen.
  • Een 'abonnementsgegevensbestand' is een XML-bestand dat veilig op uw computer kan worden opgeslagen. Deze wordt standaard opgeslagen in uw zwervende gebruikersprofiel ($home/AppData/Roaming).