Esporta in un file informazioni sugli alias attualmente definiti.

Sintassi

Export-Alias [-Path] <string> [[-Name] <string[]>] [-Append] [-As {<Csv> | <Script>}] [-Description <string>] [-Force] [-NoClobber] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrizione

Il cmdlet Export-Alias consente di esportare gli alias nella sessione corrente in un file. Se il file di output non esiste, viene creato automaticamente.

Export-Alias può esportare gli alias in un determinato ambito o in tutti gli ambiti, può generare i dati in formato CSV o come serie di comandi Set-Alias che è possibile aggiungere a una sessione o a un profilo di Windows PowerShell.

Parametri

-Append

Accoda l'output al file specificato, anziché sovrascrivere il contenuto esistente del file.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-As <ExportAliasFormat>

Determina il formato dell'output. Il formato predefinito è CSV.

I valori validi sono:

-- CSV: formato con valori separati da virgole.

-- Script: crea un comando Set-Alias per ogni alias esportato. Se si assegna un nome al file di output con estensione ps1, è possibile eseguirlo come script per aggiungere gli alias a qualsiasi sessione.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Description <string>

Aggiunge una descrizione al file esportato. La descrizione viene visualizzata come commento nella parte iniziale del file dopo le informazioni dell'intestazione.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Force

Sovrascrive il file di output, anche se per il file è impostato l'attributo di sola lettura.

Per impostazione predefinita, Export-Alias sovrascrive i file senza alcun messaggio di avviso, a meno che non sia impostato l'attributo nascosto o di sola lettura o non si utilizzi il parametro NoClobber nel comando. Tale parametro ha la precedenza sul parametro Force quando entrambi vengono utilizzati in un comando.

Il parametro Force non può forzare la sovrascrittura tramite Export-Alias di file con l'attributo nascosto.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Does not overwrite read-only files.

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Name <string[]>

Specifica i nomi degli alias da esportare. È consentito l'utilizzo di caratteri jolly.

Per impostazione predefinita, Export-Alias esporta tutti gli alias nella sessione o nell'ambito.

Obbligatorio?

false

Posizione?

2

Valore predefinito

Export all aliases

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-NoClobber

Impedisce la sovrascrittura di file mediante Export-Alias, anche se nel comando viene utilizzato il parametro Force.

Se viene omesso il parametro NoClobber, Export-Alias sovrascrive un file esistente senza alcun messaggio di avviso, a meno che per il file non sia stato impostato l'attributo di sola lettura. NoClobber ha la precedenza sul parametro Force, pertanto Export-Alias è in grado di sovrascrivere un file con l'attributo di sola lettura.

NoClobber non impedisce l'aggiunta di contenuto a un file esistente tramite il parametro Append.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Overwrites read-write files.

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-PassThru

Restituisce oggetti che rappresentano gli alias esportati. Per impostazione predefinita, il cmdlet non genera alcun output.

Obbligatorio?

false

Posizione?

named

Valore predefinito

No output

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Path <string>

Specifica il percorso del file di output. È consentito l'utilizzo di caratteri jolly, ma il percorso risultante deve essere risolto in un singolo nome file. Questo parametro è obbligatorio.

Obbligatorio?

true

Posizione?

1

Valore predefinito

nessuno

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Scope <string>

Specifica l'ambito da cui esportare gli alias.

I valori validi sono "Global", "Local", "Script" oppure un numero relativo all'ambito corrente, ovvero da 0 al numero di ambiti, dove 0 corrisponde all'ambito corrente e 1 al relativo padre. Il valore predefinito è "Local". Per ulteriori informazioni, vedere about_Scopes.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Local

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

Nessuno.

Non è possibile reindirizzare oggetti a questo cmdlet.

Output

Nessuno o System.Management.Automation.AliasInfo

Quando si utilizza il parametro PassThru, Export-Alias restituisce un oggetto System.Management.Automation.AliasInfo che rappresenta l'alias. Negli altri casi, il cmdlet non genera alcun output.

Note

È possibile esportare alias tramite Export-Alias solo in un file.

Esempio 1

C:\PS>export-alias -path alias.csv

Descrizione
-----------
Con questo comando le informazioni correnti sull'alias verranno esportate in un file denominato Alias.csv nella directory corrente.






Esempio 2

C:\PS>export-alias -path alias.csv -noclobber

Descrizione
-----------
Con questo comando gli alias nella sessione corrente vengono esportati nel file Alias.csv. 

Poiché non viene specificato alcun parametro NoClobber, il comando non viene eseguito se nella directory corrente è già presente un file denominato Alias.csv.






Esempio 3

C:\PS>export-alias -path alias.csv -append -description "Appended Aliases" -force

Descrizione
-----------
Con questo comando gli alias nella sessione corrente vengono aggiunti al file Alias.csv. 

Viene utilizzato il parametro Description per aggiungere una descrizione ai commenti nella parte iniziale del file. 

Viene inoltre utilizzato il parametro Force per sovrascrivere qualsiasi file Alias.csv esistente, anche se dispone dell'attributo di sola lettura.






Esempio 4

C:\PS>export-alias -path alias.ps1 -as script

C:\PS> add-content -path $profile -value (get-content alias.ps1)

C:\PS> $s = new-pssession -computername Server01
C:\PS> invoke-command -session $s -filepath .\alias.ps1

Descrizione
-----------
In questo esempio viene illustrato come utilizzare il formato file script generato da Export-Alias.

Con il primo comando gli alias nella sessione vengono esportati nel file Alias.ps1. Viene utilizzato il parametro As con il valore Script per generare un file che contiene un comando Set-Alias per ciascun alias.

Con il secondo comando gli alias nel file Alias.ps1 vengono aggiunti al profilo CurrentUser-CurrentHost. Il percorso del profilo viene salvato nella variabile $profile. Vengono utilizzati il cmdlet Get-Content per ottenere gli alias dal file Alias.ps1 e il cmdlet Add-Content per aggiungerli al profilo. Per ulteriori informazioni, vedere about_Profiles.

Con il terzo e il quarto comando gli alias nel file Alias.ps1 vengono aggiunti a una sessione remota del computer Server01. Nel terzo comando viene utilizzato il cmdlet New-PSSession per creare la sessione, nel quarto comando viene utilizzato il parametro FilePath del cmdlet Invoke-Command per eseguire il file Alias.ps1 nella nuova sessione.






Vedere anche




Argomenti della Guida