Dela via

Get-AzurePublishSettingsFile

  • Referens
Modul:
Azure

Laddar ned filen med publiceringsinställningar för en Azure-prenumeration.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

Syntax

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

Description

Cmdleten Get-AzurePublishSettingsFile laddar ned en fil med publiceringsinställningar för en prenumeration i ditt konto. När kommandot har slutförts kan du använda cmdleten Import-PublishSettingsFile för att göra inställningarna i filen tillgängliga för Windows PowerShell.

Om du vill göra ditt Azure-konto tillgängligt för Windows PowerShell kan du använda en fil för publiceringsinställningar eller cmdleten Add-AzureAccount . Med publiceringsinställningar kan du förbereda sessionen i förväg så att du kan köra skript och bakgrundsjobb obevakade. Alla tjänster stöder dock inte publiceringsinställningar. Modulen AzureResourceManager stöder till exempel inte publiceringsinställningar.

När du kör Get-AzurePublishSettingsFile öppnas standardwebbläsaren och du uppmanas att logga in på ditt Azure-konto, välja en prenumeration och välja en filsystemplats för filen publicera inställningar. Sedan laddar den ned filen med publiceringsinställningar för din prenumeration till den fil som du har valt.

En "fil för publiceringsinställningar" är en XML-fil med filnamnstillägget .publishsettings. Filen innehåller ett kodat certifikat som tillhandahåller autentiseringsuppgifter för hantering för dina Azure-prenumerationer.

Säkerhetsmeddelande: Publicera inställningsfiler innehåller autentiseringsuppgifter som används för att administrera dina Azure-prenumerationer och -tjänster. Om skadliga användare kommer åt filen med publiceringsinställningar kan de redigera, skapa och ta bort dina Azure-tjänster. Vi rekommenderar att du sparar filen på en plats i mappen Nedladdningar eller dokument och sedan tar bort den när du har använt cmdleten Import-AzurePublishSettingsFile för att importera inställningarna.

Det här avsnittet beskriver cmdleten i 0.8.10-versionen av Microsoft Azure PowerShell-modulen. Om du vill hämta den version av modulen som du använder skriver (Get-Module -Name Azure).Versiondu i Azure PowerShell-konsolen .

Exempel

Exempel 1: Ladda ned en fil för publiceringsinställningar

PS C:\> Get-AzurePublishSettingsFile

Det här kommandot öppnar din standardwebbläsare, ansluter till ditt Windows Azure-konto och laddar sedan ned filen .publishsettings för ditt konto.

Exempel 2: Ange en sfär

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

Det här kommandot laddar ned filen publicera inställningar för ett konto i contoso.com domänen. Använd ett kommando med parametern Realm när du loggar in på Azure med ett organisationskonto i stället för ett Microsoft-konto.

Parametrar

-Environment

Anger en Azure-miljö.

En Azure-miljö en oberoende distribution av Microsoft Azure, till exempel AzureCloud för globala Azure och AzureChinaCloud för Azure som drivs av 21Vianet i Kina. Du kan också skapa lokala Azure-miljöer med hjälp av Azure Pack och WAPack-cmdletarna. Mer information finns i Azure Pack.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar $True om kommandot lyckas och $False om det misslyckas. Som standard returnerar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Realm

Anger organisationen i ett organisations-ID. Om du till exempel loggar in på Azure som admin@contoso.comär värdet för parametern Realm contoso.com. Använd den här parametern när du använder ett organisations-ID för att logga in på Azure-portalen. Den här parametern krävs inte när du använder ett Microsoft-konto, till exempel ett outlook.com- eller live.com-konto.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

None

Du kan skicka indata till den här cmdleten efter egenskapsnamn, men inte efter värde.

Utdata

None or System.Boolean

När du använder parametern PassThru returnerar den här cmdleten ett booleskt värde. Annars returnerar den här cmdleten inga utdata