Sdílet prostřednictvím

Get-AzurePublishSettingsFile

  • Reference
Modul:
Azure

Stáhne soubor nastavení publikování pro předplatné Azure.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Description

Rutina Get-AzurePublishSettingsFile stáhne soubor nastavení publikování pro předplatné ve vašem účtu. Po dokončení příkazu můžete pomocí rutiny Import-PublishSettingsFile zpřístupnit nastavení v souboru pro Windows PowerShell.

K zpřístupnění účtu Azure pro Windows PowerShell můžete použít soubor nastavení publikování nebo rutinu Add-AzureAccount . Soubory nastavení publikování umožňují předem připravit relaci, abyste mohli bezobslužné spouštění skriptů a úloh na pozadí. Ne všechny služby však podporují soubory nastavení publikování. Například modul AzureResourceManager nepodporuje soubory nastavení publikování.

Když spustíte Get-AzurePublishSettingsFile, otevře se výchozí prohlížeč a vyzve vás, abyste se přihlásili ke svému účtu Azure, vybrali předplatné a vybrali umístění systému souborů pro soubor nastavení publikování. Potom stáhne soubor nastavení publikování pro vaše předplatné do souboru, který jste vybrali.

Soubor nastavení publikování je soubor XML s příponou názvu souboru .publishsettings. Soubor obsahuje zakódovaný certifikát, který poskytuje přihlašovací údaje pro správu vašich předplatných Azure.

Poznámka zabezpečení: Soubory nastavení publikování obsahují přihlašovací údaje, které slouží ke správě předplatných a služeb Azure. Pokud uživatelé se zlými úmysly přistupují k souboru nastavení publikování, můžou upravovat, vytvářet a odstraňovat služby Azure. Osvědčeným postupem zabezpečení je uložit soubor do umístění ve složce Stažené soubory nebo Dokumenty a potom ho odstranit po použití rutiny Import-AzurePublishSettingsFile k importu nastavení.

Toto téma popisuje rutinu ve verzi 0.8.10 modulu Microsoft Azure PowerShell. Pokud chcete získat verzi modulu, který používáte, zadejte (Get-Module -Name Azure).Versionv konzole Azure PowerShellu .

Příklady

Příklad 1: Stažení souboru nastavení publikování

PS C:\> Get-AzurePublishSettingsFile

Tento příkaz otevře výchozí prohlížeč, připojí se k účtu Windows Azure a pak stáhne soubor .publishsettings pro váš účet.

Příklad 2: Určení sféry

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

Tento příkaz stáhne soubor nastavení publikování pro účet v contoso.com doméně. Příkaz s parametrem Sféra použijte při přihlášení k Azure pomocí účtu organizace místo účtu Microsoft.

Parametry

-Environment

Určuje prostředí Azure.

Prostředí Azure nezávislé nasazení Microsoft Azure, jako je AzureCloud pro globální Azure a AzureChinaCloud pro Azure provozované společností 21Vianet v Číně. Místní prostředí Azure můžete vytvořit také pomocí azure Packu a rutin WAPacku. Další informace najdete v tématu Azure Pack.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Vrátí $True, pokud příkaz proběhne úspěšně a $False, pokud selže. Ve výchozím nastavení tato rutina nevrací žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Realm

Určuje organizaci v ID organizace. Pokud se například přihlásíte k Azure jako admin@contoso.com, hodnota parametru Sféra je contoso.com. Tento parametr použijte, když k přihlášení k webu Azure Portal použijete ID organizace. Tento parametr se nevyžaduje, pokud používáte účet Microsoft, například outlook.com nebo live.com účet.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny můžete řadit podle názvu vlastnosti, ale ne podle hodnoty.

Výstupy

None or System.Boolean

Pokud použijete parametr PassThru , vrátí tato rutina logickou hodnotu. Jinak tato rutina nevrací žádný výstup.