Delen via

Get-AzurePublishSettingsFile

  • Referentie
Module:
Azure

Hiermee downloadt u het bestand met publicatie-instellingen voor een Azure-abonnement.

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

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

Description

De cmdlet Get-AzurePublishSettingsFile downloadt een publicatie-instellingenbestand voor een abonnement in uw account. Wanneer de opdracht is voltooid, kunt u de cmdlet Import-PublishSettingsFile gebruiken om de instellingen in het bestand beschikbaar te maken voor Windows PowerShell.

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.

Wanneer u Get-AzurePublishSettingsFile uitvoert, wordt uw standaardbrowser geopend en wordt u gevraagd u aan te melden bij uw Azure-account, een abonnement te selecteren en een bestandssysteemlocatie te selecteren voor het bestand met publicatie-instellingen. Vervolgens wordt het bestand met publicatie-instellingen voor uw abonnement gedownload naar het bestand dat u hebt geselecteerd.

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.

Beveiligingsnotitie: Publicatie-instellingenbestanden bevatten referenties die worden gebruikt voor het beheren van uw Azure-abonnementen en -services. Als kwaadwillende gebruikers toegang hebben tot uw publicatie-instellingenbestand, kunnen ze uw Azure-services 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.

In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven. Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.

Voorbeelden

Voorbeeld 1: Een publicatie-instellingenbestand downloaden

PS C:\> Get-AzurePublishSettingsFile

Met deze opdracht opent u uw standaardbrowser, maakt u verbinding met uw Windows Azure-account en downloadt u vervolgens het .publishsettings-bestand voor uw account.

Voorbeeld 2: Een realm opgeven

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

Met deze opdracht wordt het bestand met publicatie-instellingen voor een account in het contoso.com domein gedownload. Gebruik een opdracht met de parameter Realm wanneer u zich aanmeldt bij Azure met een organisatieaccount, in plaats van een Microsoft-account.

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:True
Jokertekens accepteren:False

-PassThru

Retourneert $True als de opdracht slaagt en $False als deze mislukt. Deze cmdlet retourneert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
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

-Realm

Hiermee geeft u de organisatie in een organisatie-id. Als u zich bijvoorbeeld aanmeldt bij Azure als admin@contoso.com, wordt de waarde van de parameter Realm contoso.com. Gebruik deze parameter wanneer u een organisatie-id gebruikt om u aan te melden bij Azure Portal. Deze parameter is niet vereist wanneer u een Microsoft-account gebruikt, zoals een outlook.com- of live.com-account.

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

Invoerwaarden

None

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

Uitvoerwaarden

None or System.Boolean

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een Booleaanse waarde. Anders retourneert deze cmdlet geen uitvoer