Condividi tramite

Get-AzurePublishSettingsFile

  • Riferimento
Modulo:
Azure

Scarica il file delle impostazioni di pubblicazione per una sottoscrizione di Azure.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Get-AzurePublishSettingsFile scarica un file di impostazioni di pubblicazione per una sottoscrizione nell'account. Al termine del comando, è possibile usare il cmdlet Import-PublishSettingsFile per rendere disponibili le impostazioni nel file per Windows PowerShell.

Per rendere disponibile l'account Azure per Windows PowerShell, è possibile usare un file di impostazioni di pubblicazione o il cmdlet Add-AzureAccount . I file di impostazioni di pubblicazione consentono di preparare la sessione in anticipo in modo da poter eseguire script e processi in background automaticamente. Tuttavia, non tutti i servizi supportano i file delle impostazioni di pubblicazione. Ad esempio, il modulo AzureResourceManager non supporta i file di impostazioni di pubblicazione.

Quando si esegue Get-AzurePublishSettingsFile, viene aperto il browser predefinito e viene richiesto di accedere all'account Azure, selezionare una sottoscrizione e selezionare un percorso del file system per il file di impostazioni di pubblicazione. Scarica quindi il file delle impostazioni di pubblicazione per la sottoscrizione nel file selezionato.

Un "file delle impostazioni di pubblicazione" è un file XML con estensione publishsettings. Il file contiene un certificato codificato che fornisce le credenziali di gestione per le sottoscrizioni di Azure.

Nota sulla sicurezza: i file di impostazioni di pubblicazione contengono credenziali usate per amministrare le sottoscrizioni e i servizi di Azure. Se gli utenti malintenzionati accedono al file delle impostazioni di pubblicazione, possono modificare, creare ed eliminare i servizi di Azure. Come procedura consigliata per la sicurezza, salvare il file in un percorso nella cartella Download o Documenti e quindi eliminarlo dopo aver usato il cmdlet Import-AzurePublishSettingsFile per importare le impostazioni.

Questo argomento descrive il cmdlet nella versione 0.8.10 del modulo Microsoft Azure PowerShell. Per ottenere la versione del modulo in uso, nella console di Azure PowerShell digitare (Get-Module -Name Azure).Version.

Esempio

Esempio 1: Scaricare un file di impostazioni di pubblicazione

PS C:\> Get-AzurePublishSettingsFile

Questo comando apre il browser predefinito, si connette all'account di Windows Azure e quindi scarica il file publishsettings per l'account.

Esempio 2: Specificare un'area di autenticazione

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

Questo comando scarica il file delle impostazioni di pubblicazione per un account nel dominio contoso.com. Usare un comando con il parametro Realm quando si accede ad Azure con un account aziendale anziché con un account Microsoft.

Parametri

-Environment

Specifica un ambiente di Azure.

Un ambiente Azure una distribuzione indipendente di Microsoft Azure, ad esempio AzureCloud per Azure globale e AzureChinaCloud per Azure gestito da 21Vianet in Cina. È anche possibile creare ambienti di Azure locali usando Azure Pack e i cmdlet WAPack. Per altre informazioni, vedere Azure Pack.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce $True se il comando ha esito positivo e $False in caso di errore. Per impostazione predefinita, questo cmdlet non restituisce alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Realm

Specifica l'organizzazione in un ID organizzazione. Ad esempio, se si accede ad Azure come admin@contoso.com, il valore del parametro Realm è contoso.com. Usare questo parametro quando si usa un ID organizzazione per accedere al portale di Azure. Questo parametro non è obbligatorio quando si usa un account Microsoft, ad esempio un account outlook.com o live.com.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

None

È possibile inviare tramite pipe l'input a questo cmdlet in base al nome della proprietà, ma non in base al valore.

Output

None or System.Boolean

Quando si usa il parametro PassThru , questo cmdlet restituisce un valore booleano. In caso contrario, questo cmdlet non restituisce alcun output