Import-AzurePublishSettingsFile

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 Service Management-API's. Zie de Az PowerShell-module voor cmdlets voor het beheren van Azure Resource Manager-resources.

Syntax

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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishSettingsFile

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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).