Condividi tramite

Import-AzurePublishSettingsFile

  • Riferimento
Modulo:
Azure

Importa un file di impostazioni di pubblicazione che consente di gestire gli account Azure in Windows PowerShell.

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

Import-AzurePublishSettingsFile
      -PublishSettingsFile <String>
      [-Environment <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Descrizione

Il cmdlet Import-AzurePublishSettingsFile importa un file di impostazioni di pubblicazione (*.publishsettings) che contiene informazioni sugli account Azure e salva un file di dati della sottoscrizione nel computer. Al termine del cmdlet, è possibile gestire gli account Azure in Windows PowerShell.

Prima di eseguire Import-AzurePublishSettingsFile, eseguire Get-AzurePublishSettingsFile, che scarica e salva il file delle impostazioni di pubblicazione in modo da poterlo importare.

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.

Nota sulla sicurezza: i file di impostazioni di pubblicazione contengono un certificato di gestione codificato, ma non crittografato. Se gli utenti malintenzionati accedono al file delle impostazioni di pubblicazione, potrebbero essere in grado di 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.

Esempio

Esempio 1: Importare un file

PS C:\> Import-AzurePublishSettingsFile -PublishSettingsFile C:\Temp\MyAccount.publishsettings

Questo comando importa il file "C:\Temp\MyAccount.publishsettings".

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:False
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

-PublishSettingsFile

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
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

Questo cmdlet non genera alcun output.

Note

  • 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. Dopo aver importato questo file, eliminarlo per evitare rischi per la sicurezza.
  • Un "file di dati di sottoscrizione" è un file XML che può essere salvato nel computer in modo sicuro. Per impostazione predefinita, viene salvato nel profilo utente mobile ($home/AppData/Roaming).