Cmdlet dello strumento di configurazione automatizzata per la migrazione

Questa pagina elenca tutti i cmdlet e i parametri supportati dallo strumento per i casi d’uso di migrazione.

Tutti i cmdlet accettano parametri che appartengono a uno dei seguenti tipi.

• Corda
• Elenco delle stringhe
• Booleano: $true o $false
• SwitchParameter: la presenza del parametro significa $true; l’assenza del parametro significa $false

Nota:

SwitchParameter è il metodo preferito per le selezioni vero o falso, ma i valori booleani vengono ancora utilizzati nello strumento a causa di problemi legacy.

La tabella seguente è un riepilogo di tutti i cmdlet. Consultare ogni singola sezione per scoprire quali parametri sono supportati da ciascun cmdlet.

Per maggiori informazioni sui parametri e su come utilizzarli, vedere Parametri di migrazione granulare.

Cmdlet di base

Cmdlet da locale a cloud

• Export-CvadAcToFile - Esporta i file locali in file YAML.

  Esporta la configurazione dalla tua configurazione locale. Questa è l’operazione di esportazione predefinita per la configurazione automatizzata. Non vengono apportate modifiche alla configurazione del sito on-premise. I file esportati vengono posizionati nella directory %HOMEPATH%\Documents\Citrix\AutoConfig in una sottocartella con nome univoco Export . La cartella %HOMEPATH%\Documents\Citrix\AutoConfig contiene sempre l’ultima configurazione del sito locale esportata.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedi Migrazione per componenti		Parametri di commutazione
  Filtraggio per nomi di oggetti	Vedere Filtraggio per nomi di oggetti		Elenco delle stringhe
  TargetFolder	Specifica la cartella di destinazione dell’esportazione.		Corda
  Locale	Specifica la lingua del testo leggibile che può essere esportato.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  AdminAddress	Specifica il DNS o l’indirizzo IP del Delivery Controller quando l’esportazione non viene eseguita sul Delivery Controller.		Corda
  CheckUserAndMachines	Verifica se gli utenti e i computer sono in Active Directory. Gli utenti e i computer che non sono presenti in Active Directory potrebbero causare errori di importazione.		$true or $false
  ZipResults	Gli zip salvano i file YAML in un unico file zip. Il file si trova nella stessa cartella dei file YAML sottoposti a backup e ha lo stesso nome della cartella.		Parametro di commutazione

  Resi:

  • Vedere Valori restituiti dal cmdlet

Esistono tre modi per importare dati nel cloud. L’esecuzione di cmdlet specifici può comportare una delle tre combinazioni di azioni sul sito cloud:

• Aggiungi, aggiorna ed elimina
• Aggiungi e aggiorna solo
• Aggiungi solo

• Import-CvadAcToSite - Importa file YAML nel cloud. Supporta le operazioni di creazione, aggiornamento ed eliminazione.

  Importa tutti i file locali nel cloud. Questo comando garantisce che lo stato finale del cloud sia identico allo stato on-premise. Questa opzione elimina tutte le modifiche presenti nel cloud. I file di configurazione del sito importati provengono da %HOMEPATH%\Documents\Citrix\AutoConfig. Da usare con cautela.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedere Migrazione per componenti.		Parametri di commutazione
  Filtraggio per nomi di oggetti	Vedere Filtraggio per nomi di oggetti.		Elenco delle stringhe
  Parametri di accesso al cloud	Vedere Parametri di accesso al cloud.		Parametri di commutazione
  SourceFolder	Identifica una cartella radice sostitutiva per %HOMEPATH%\Documents\Citrix\AutoConfig.		Corda
  Locale	Specifica la lingua del testo leggibile che può essere esportato.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false
  Unisci	Se impostato su $true, aggiunge componenti solo al sito cloud. I componenti non vengono rimossi. Impostare su $false per rimuovere i componenti.		$true or $false
  AddOnly	Se impostato su $true, aggiunge solo nuovi componenti, non aggiorna né elimina i componenti esistenti. Impostare su $false per consentire aggiornamenti ed eliminazioni. Merge viene ignorato quando questo parametro è $true.		$true or $false
  MergePolicies	Unisci impostazioni e filtri dei criteri. L’unione avviene solo quando una policy importata esiste già nel cloud DDC. Il risultato dell’unione delle policy è che le policy DDC cloud contengono le impostazioni e i filtri già presenti, oltre a tutte le nuove impostazioni e filtri importati. Si noti che quando si verificano collisioni tra impostazioni e filtri, i valori importati hanno la precedenza.		Parametro di commutazione
  OnErrorAction	Vedere parametro OnErrorAction.		Corda

  Resi:

  • Vedere Valori restituiti dal cmdlet

• Merge-CvadAcToSite - Importa file YAML nel cloud. Supporta le operazioni di creazione e aggiornamento.

  Unisce i file locali al cloud, ma non elimina alcun componente nel cloud o nel sito locale. In questo modo vengono conservate le modifiche già apportate nel cloud. Se in Citrix Cloud esiste un componente con lo stesso nome, questo comando può modificare tale componente. Questa è l’operazione di importazione predefinita per la configurazione automatizzata. I file di configurazione del sito unito provengono da %HOMEPATH%\Documents\Citrix\AutoConfig.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedere Migrazione per componenti.		Parametri di commutazione
  Filtraggio per nomi di oggetti	Vedere Filtraggio per nomi di oggetti.		Elenco delle stringhe
  Parametri di accesso al cloud	Vedere Parametri di accesso al cloud.		Parametri di commutazione
  SourceFolder	Identifica una cartella radice sostitutiva per %HOMEPATH%\Documents\Citrix\AutoConfig.		Corda
  Locale	Specifica la lingua del testo leggibile che può essere esportato.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false
  Unisci	Se impostato su $true, aggiunge componenti solo al sito cloud. I componenti non vengono rimossi. Impostare su $false per rimuovere i componenti.		$true or $false
  AddOnly	Se impostato su $true, aggiunge solo nuovi componenti, non aggiorna né elimina i componenti esistenti. Impostare su $false per consentire aggiornamenti ed eliminazioni. Merge viene ignorato quando questo parametro è $true.		$true or $false
  MergePolicies	Unisci impostazioni e filtri dei criteri. L’unione avviene solo quando una policy importata esiste già nel cloud DDC. Il risultato dell’unione delle policy è che le policy DDC cloud contengono le impostazioni e i filtri già presenti, oltre a tutte le nuove impostazioni e filtri importati. Si noti che quando si verificano collisioni tra impostazioni e filtri, i valori importati hanno la precedenza.		Parametro di commutazione
  OnErrorAction	Vedere parametro OnErrorAction.		Corda

  Resi:

  • Vedere Valori restituiti dal cmdlet

• New-CvadAcToSite - Importa file YAML nel cloud. Supporta le operazioni di creazione e aggiornamento.

  Importa la configurazione del sito locale nel cloud, ma aggiunge solo nuovi componenti. I componenti esistenti del sito cloud non vengono né aggiornati né eliminati. Utilizza questo comando se i componenti del tuo sito cloud esistente devono rimanere invariati.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedere Migrazione per componenti.		Parametri di commutazione
  Filtraggio per nomi di oggetti	Vedere Filtraggio per nomi di oggetti.		Elenco delle stringhe
  Parametri di accesso al cloud	Vedere Parametri di accesso al cloud.		Parametri di commutazione
  SourceFolder	Identifica una cartella radice sostitutiva per %HOMEPATH%\Documents\Citrix\AutoConfig.		Corda
  Locale	Specifica la lingua del testo leggibile che può essere esportato.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false
  OnErrorAction	Vedere parametro OnErrorAction.		Corda

  Resi:

  • Vedere Valori restituiti dal cmdlet

• Sync-CvadAcToSite - Esporta e importa in un unico passaggio.

  Sync esegue sia l’esportazione che l’importazione in un unico passaggio. Utilizzare il parametro SourceTargetFolder per specificare la cartella di destinazione per l’esportazione/importazione.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedi Migrazione per componenti		Parametri di commutazione
  Filtraggio per nomi di oggetti	Vedere Filtraggio per nomi di oggetti		Elenco delle stringhe
  Parametri di accesso al cloud	Vedi Parametri di accesso al cloud		Parametri di commutazione
  SourceTargetFolder	Specifica la cartella di destinazione per l’esportazione/importazione.		Corda
  Locale	Specifica la lingua del testo leggibile che può essere esportato.		Corda
  AdminAddress	Specifica il DNS o l’indirizzo IP del delivery controller quando l’esportazione non viene eseguita sul delivery controller.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false
  Unisci	Se impostato su $true, aggiunge componenti solo al sito cloud. I componenti non vengono rimossi. Impostare su $false per rimuovere i componenti.		$true or $false
  AddOnly	Se impostato su $true, aggiunge solo nuovi componenti, non aggiorna né elimina i componenti esistenti. Impostare su $false per consentire aggiornamenti ed eliminazioni. Merge viene ignorato quando questo parametro è $true.		$true or $false
  MergePolicies	Unisci impostazioni e filtri dei criteri. L’unione avviene solo quando una policy importata esiste già nel cloud DDC. Il risultato dell’unione delle policy è che le policy DDC cloud contengono le impostazioni e i filtri già presenti, oltre a tutte le nuove impostazioni e filtri importati. Si noti che quando si verificano collisioni tra impostazioni e filtri, i valori importati hanno la precedenza.		Parametro di commutazione

  Resi:

  • Vedere Valori restituiti dal cmdlet

Cmdlet da cloud a cloud

• Backup-CvadAcToFile - Esegue il backup di tutta la configurazione dal tuo sito cloud.

  Esporta la configurazione del cloud in file .yml. Questo backup può essere utilizzato in un processo di backup e ripristino per ripristinare i componenti persi.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedi Migrazione per componenti		Parametri di commutazione
  Parametri di accesso al cloud	Vedi Parametri di accesso al cloud		Parametri di commutazione
  TargetFolder	Specifica la cartella di destinazione dell’esportazione.		Corda
  Locale	Specifica la lingua del testo leggibile che può essere esportato.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false
  ZipResults	Gli zip salvano i file YAML in un unico file zip. Il file si trova nella stessa cartella dei file YAML sottoposti a backup e ha lo stesso nome della cartella.		Parametro di commutazione

  Resi:

  • Vedere Valori restituiti dal cmdlet

• Restore-CvadAcToSite - Ripristina i file YAML di backup sul sito cloud. Questo sito cloud può essere uguale o diverso dal sito cloud di origine.

  Ripristina il sito cloud alla configurazione precedente. I file importati provengono dalla cartella specificata utilizzando il parametro -RestoreFolder , che identifica la cartella contenente i file .yml da ripristinare sul sito cloud. Deve trattarsi di una specifica di cartella completamente qualificata. Questo cmdlet può essere utilizzato per ripristinare la configurazione precedente o per eseguire il backup e il ripristino del sito cloud. Questo comando può aggiungere, eliminare e aggiornare il tuo sito cloud.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedere Migrazione per componenti.		Parametri di commutazione
  Filtraggio per nomi di oggetti	Vedere Filtraggio per nomi di oggetti.		Elenco delle stringhe
  Parametri di accesso al cloud	Vedere Parametri di accesso al cloud.		Parametri di commutazione
  RestoreFolder	Identifica la cartella contenente i file .yml da ripristinare sul sito cloud. Deve trattarsi di una specifica di cartella completamente qualificata.		Corda
  Locale	Specifica la lingua del testo leggibile che può essere esportato.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false
  Unisci	Se impostato su $true, aggiunge componenti solo al sito cloud. I componenti non vengono rimossi. Impostare su $false per rimuovere i componenti.		$true or $false
  AddOnly	Se impostato su $true, aggiunge solo nuovi componenti, non aggiorna né elimina i componenti esistenti. Impostare su $false per consentire aggiornamenti ed eliminazioni. Merge viene ignorato quando questo parametro è $true.		$true or $false
  MergePolicies	Unisci impostazioni e filtri dei criteri. L’unione avviene solo quando una policy importata esiste già nel cloud DDC. Il risultato dell’unione delle policy è che le policy DDC cloud contengono le impostazioni e i filtri già presenti, oltre a tutte le nuove impostazioni e filtri importati. Si noti che quando si verificano collisioni tra impostazioni e filtri, i valori importati hanno la precedenza.		Parametro di commutazione
  OnErrorAction	Vedere parametro OnErrorAction.		Corda

  Resi:

  • Vedere Valori restituiti dal cmdlet

• Remove-CvadAcFromSite – Rimuove i membri del componente dal cloud.

  È possibile reimpostare l’intero sito o rimuovere elementi membro da un componente (ad esempio, rimuovendo un catalogo macchina dall’elenco dei cataloghi). Può essere utilizzato insieme al parametro IncludeByName per rimuovere selettivamente membri specifici.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedi Migrazione per componenti		Parametri di commutazione
  Filtraggio per nomi di oggetti	Vedere Filtraggio per nomi di oggetti		Elenco delle stringhe
  Parametri di accesso al cloud	Vedi Parametri di accesso al cloud		Parametri di commutazione
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false

  Resi:

  • Vedere Valori restituiti dal cmdlet

Altri cmdlet di base

• Compare-CvadAcToSite - Confronta i file .yml locali con la configurazione cloud, producendo un report delle modifiche apportate da un cmdlet Import, Mergeo Restore .

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedere Migrazione per componenti.		Parametri di commutazione
  Filtraggio per nomi di oggetti	Vedere Filtraggio per nomi di oggetti.		Elenco delle stringhe
  Parametri di accesso al cloud	Vedere Parametri di accesso al cloud.		Parametri di commutazione
  SourceFolder	Identifica una cartella radice sostitutiva per %HOMEPATH%\Documents\Citrix\AutoConfig.		Corda
  Locale	Specifica la lingua del testo leggibile che può essere esportato.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false
  Unisci	Se impostato su $true, aggiunge componenti solo al sito cloud. I componenti non vengono rimossi. Impostare su $false per rimuovere i componenti.		$true or $false
  AddOnly	Se impostato su $true, aggiunge solo nuovi componenti, non aggiorna né elimina i componenti esistenti. Impostare su $false per consentire aggiornamenti ed eliminazioni. Merge viene ignorato quando questo parametro è $true.		$true or $false
  OnErrorAction	Vedere parametro OnErrorAction.		Corda

  Resi:

  • Vedere Valori restituiti dal cmdlet

Parametri di migrazione granulari

Migrazione per componenti

È possibile specificare i seguenti componenti con cmdlet che li supportano. L’opzione Tutti viene selezionata automaticamente quando non vengono specificati parametri dei componenti. Per evitare errori, ti consigliamo di migrare i componenti nel seguente ordine:

• All
• Tags
• AdminRoles
• AdminScopes
• HostConnections
• MachineCatalogs
• StoreFronts
• DeliveryGroups
• ApplicationGroups
• ApplicationFolders
• Applications
• GroupPolicies
• UserZonePreference

Filtraggio per nomi di oggetti

Migrazione per nomi di componenti

I parametri IncludeByName e ExcludeByName consentono di includere ed escludere i membri dei componenti nei cmdlet in base al nome. È possibile scegliere un solo componente alla volta (ad esempio, gruppi di distribuzione) in uno qualsiasi dei cmdlet supportati. Se un membro del componente è presente in entrambe le aree, l’esclusione sostituisce qualsiasi altro parametro e nell’elenco di correzione del registro viene inserita una voce che identifica il nome del componente e del membro che è stato escluso.

IncludeByName e ExcludeByName accettano un elenco di nomi di membri del componente. Ogni nome può contenere uno o più caratteri jolly. Sono supportati due tipi di caratteri jolly. L’elenco dei nomi dei membri del componente deve essere racchiuso tra virgolette singole quando un nome di membro contiene caratteri speciali.

• * Corrisponde a qualsiasi numero di caratteri
• ? Corrisponde a un singolo carattere

IncludeByName e ExcludeByName possono anche accettare un file contenente un elenco di membri in cui ogni membro può essere esplicito o contenere caratteri jolly. Ogni riga del file può contenere un membro. Gli spazi iniziali e finali vengono eliminati dal nome del membro. Il nome del file deve essere preceduto dal simbolo @ e racchiuso tra virgolette singole (un requisito di PowerShell affinché il simbolo @ non venga reinterpretato). È possibile elencare più file, oltre a mescolarli con i nomi dei membri.

Un esempio di unione di tutti i gruppi di distribuzione i cui nomi iniziano con DgSite1 e contengono Home2 sarebbe scritto:

Merge-CvadAcToSite –DeliveryGroups –IncludeByName DgSite1*,*Home2*

Per nome del gruppo di consegna

ByDeliveryGroupName filtra in base al nome del gruppo di consegna per applicazioni e gruppi di applicazioni. Questo parametro è sempre un elenco di inclusione che identifica i membri da includere in base alla loro associazione al gruppo di distribuzione.

ByDeliveryGroupName accetta un elenco di nomi di gruppi di consegna. Ogni nome può contenere uno o più caratteri jolly. Sono supportati due tipi di caratteri jolly.

• * corrisponde a qualsiasi numero di caratteri
• ? corrisponde a un singolo carattere

L’esempio seguente unisce tutte le applicazioni che fanno riferimento a tutti i nomi di gruppi di distribuzione che iniziano con EastDg.

Merge-CvadAcToSite –Applications –ByDeliveryGroupName EastDg*

Escludi Disabilitato

ExcludeDisabled esclude dalle operazioni di importazione tutte le applicazioni e i gruppi di applicazioni disabilitati. ExcludeDisabled il valore predefinito è false, il che significa che tutte le applicazioni e i gruppi di applicazioni vengono importati indipendentemente dal loro stato di abilitazione.

Per nome macchina

ByMachineName filtra in base al nome della macchina per cataloghi macchine e gruppi di consegna. Questo parametro è sempre un elenco di inclusione che identifica i membri da includere in base alla loro associazione al nome della macchina.

ByMachineName accetta un elenco di nomi di macchine in cui ogni nome può contenere uno o più caratteri jolly. Sono supportati due tipi di caratteri jolly.

• * corrisponde a qualsiasi numero di caratteri
• ? corrisponde a un singolo carattere

Quando si esporta o si importa e si utilizza ByMachineName e un filtro nome macchina non determina la presenza di macchine nel catalogo macchine o nel gruppo di distribuzione, il catalogo macchine o il gruppo di distribuzione vengono esclusi dall’esportazione o dall’importazione.

Nota:

L’utilizzo di ByMachineName in qualsiasi cmdlet di tipo importazione comporta l’impostazione di MergeMachines su $true.

Macchine di unione

MergeMachines, se impostato su $true, indica all’operazione di importazione di aggiungere macchine solo al catalogo macchine o al gruppo di distribuzione. Le macchine non vengono rimosse, consentendo operazioni additive incrementali.

MergeMachines ha come valore predefinito falso, il che significa che le macchine vengono rimosse se non sono presenti nel catalogo macchine o nel file .yml del gruppo di distribuzione. MergeMachines è impostato su $true quando viene utilizzato ByMachineName , ma può essere sovrascritto impostando MergeMachines su false.

Cmdlet correlati ai prerequisiti

• New-CvadAcCustomerInfoFile - Crea un file di informazioni sul cliente. Per impostazione predefinita, il file con le informazioni sul cliente si trova in %HOMEPATH%\Documents\Citrix\AutoConfig.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  CustomerId	ID del cliente.	X	Corda
  ClientId	ID client del cliente creato su Citrix Cloud. Quando si utilizza questo parametro, è necessario specificare CustomerId e Secret.	Condizionalmente	Corda
  Secret	Chiave segreta del cliente creata su Citrix Cloud. Quando si utilizza questo parametro, è necessario specificare CustomerId e ClientId.	Condizionalmente	Corda
  Environment	Ambiente Production, ProductionGov o ProductionJP.		Enumerazione
  LogFileName	Cambiare il prefisso del file di registro da CitrixLog a qualcos’altro.		Corda
  AltRootUrl	Utilizzare solo sotto la supervisione di Citrix.		Corda
  StopOnError	Interrompe l’operazione al primo errore.		$true or $false
  TargetFolder	Utilizzare la cartella specificata come cartella radice anziché %HOMEPATH%\Documents\Citrix\AutoConfig.		Corda
  Locale	Utilizzare le impostazioni locali specificate anziché quelle derivate dal sistema su cui viene eseguito lo strumento.		Corda
  Editor	Utilizzare l’editor specificato per visualizzare il registro al completamento di ciascun cmdlet. Notepad.exe è l’editor predefinito. Questo parametro deve includere la specifica del file completamente qualificata per l’editor e l’editor deve accettare la specifica del file di registro come unico parametro.		Corda
  SecurityCsvFileSpec	Specifica del file completamente qualificata che punta al file SecurityClient.csv scaricato da Citrix Identity and Access Management. Quando si utilizza questo parametro, è necessario specificare CustomerId.		Corda

  Resi:

  • Vedere Valori restituiti dal cmdlet

• Set-CvadAcCustomerInfoFile - Aggiorna un file di informazioni cliente esistente. Vengono modificati solo i parametri specificati dal cmdlet. Tutti i valori dei parametri non specificati nel file CustomerInfo.yml restano invariati.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  CustomerId	ID del cliente.		Corda
  ClientId	ID client del cliente creato su Citrix Cloud.		Corda
  Secret	Chiave segreta del cliente creata su Citrix Cloud.		Corda
  Environment	Ambiente Production, ProductionGov o ProductionJP.		Enumerazione
  LogFileName	Cambiare il prefisso del file di registro da CitrixLog a qualcos’altro.		Corda
  StopOnError	Interrompe l’operazione al primo errore.		$true or $false
  TargetFolder	Utilizzare la cartella specificata come cartella radice anziché %HOMEPATH%\Documents\Citrix\AutoConfig.		Corda
  Locale	Utilizzare le impostazioni locali specificate anziché quelle derivate dal sistema su cui viene eseguito lo strumento.		Corda
  Editor	Utilizzare l’editor specificato per visualizzare il registro al completamento di ciascun cmdlet. Notepad.exe è l’editor predefinito. Questo parametro deve includere la specifica del file completamente qualificata per l’editor e l’editor deve accettare la specifica del file di registro come unico parametro.		Corda
  SecurityCsvFileSpec	Specifica del file completamente qualificata che punta al file SecurityClient.csv scaricato da Citrix Identity and Access Management. Quando si utilizza questo parametro, è necessario specificare CustomerId.		Corda

  Resi:

  • Vedere Valori restituiti dal cmdlet

Parametri relativi ai prerequisiti

Insieme ai parametri di accesso al cloud , è possibile utilizzare i seguenti parametri con i cmdlet correlati ai prerequisiti:

• Ambiente – Ambiente di produzione o ProductionGov.
• LogFileName – Modifica il prefisso del file di registro da CitrixLog a qualcos’altro.
• StopOnError – Interrompe l’operazione al primo errore.
• AlternateRootFolder – Utilizza la cartella specificata come cartella radice invece di %HOMEPATH%\Documents\Citrix\AutoConfig.
• Impostazioni locali – utilizza le impostazioni locali specificate anziché quelle derivate dal sistema su cui viene eseguito lo strumento.
• Editor – utilizza l’editor specificato per visualizzare il registro al completamento di ciascun cmdlet. Notepad.exe è l’editor predefinito. Questo parametro deve includere la specifica del file completamente qualificata per l’editor e l’editor deve accettare la specifica del file di registro come unico parametro.

Cmdlet di supporto e risoluzione dei problemi

• New-CvadAcZipInfoForSupport - Comprime tutti i file di registro e .yml in un unico file zip da inviare a Citrix per supporto. Le informazioni sensibili del cliente (CustomerInfo.yml e CvadAcSecurity.yml) non sono incluse nel file zip. Anche il file Icon.yml è escluso a causa delle sue dimensioni. Il file zip viene posizionato in %HOMEPATH%\Documents\Citrix\AutoConfig e denominato CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip, in base alla data e all’ora. Questo file zip può anche fungere da backup.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  TargetFolder	Specifica una cartella di destinazione in cui creare e salvare il file zip.		Corda
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione

  Resi:

  • Nel prompt dei comandi viene visualizzato il file zip con il nome e il percorso.

• Get-CvadAcStatus - Utilizzare per testare la connettività e per garantire che tutti i prerequisiti siano soddisfatti. Restituisce informazioni sullo strumento, come il numero di versione, la connettività con il cloud e lo stato del connettore.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Parametri di accesso al cloud	Vedi Parametri di accesso al cloud		Parametri di commutazione
  SiteId	Identifica il sito a cui connettersi.		Corda
  AdminAddress	Questo è l’indirizzo DNS o IP del Delivery Controller locale utilizzato per verificare il livello di accesso degli amministratori. Questa operazione è necessaria se lo strumento non viene eseguito su un Delivery Controller.		Corda

  Resi:

  • Visualizza i risultati per ogni elemento.

• Test-CvadAcConnectionWithSite – Testa la connessione con il sito cloud per verificare che la connessione di comunicazione funzioni. Questo cmdlet utilizza i parametri di accesso al cloud o il file CustomerInfo.yml per specificare le informazioni di connessione del cliente.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Parametri di accesso al cloud	Vedi Parametri di accesso al cloud		Parametri di commutazione
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione

  Resi:

  • I risultati del test vengono visualizzati sulla riga di comando.

• Find-CvadAcConnector - Individua i connettori esistenti e determina il loro stato di esecuzione. Questo cmdlet utilizza le informazioni dal file CustomerInfo.yml o dal parametro ID cliente per individuare i connettori del cliente.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  CustomerInfoFileSpec	Specifica del file che punta a un file di informazioni sul cliente per sovrascrivere il percorso e il nome predefiniti. Questo parametro viene ignorato quando viene fornito il parametro CustomerId .		Corda
  CustomerId	L’ID del cliente. Questo parametro sostituisce lo stesso valore nel file CustomerInfo.yml.		Corda

  Resi:

  • I risultati vengono visualizzati sulla riga di comando.

• Get-CvadAcCustomerSites - Restituisce l’elenco di tutti i siti dei clienti. Questo cmdlet utilizza i parametri di accesso al cloud o il file CustomerInfo.yml per specificare le informazioni di connessione del cliente.

  Parametri:

  • Vedi Parametri di accesso al cloud

  Resi:

  • Visualizza un elenco degli ID dei siti dei clienti trovati.

• New-CvadAcTemplateToFile – Crea un file modello per i componenti selezionati, consentendo di creare manualmente un file di importazione.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedi Migrazione per componenti		Parametri di commutazione
  TargetFolder	Specifica la cartella di destinazione dell’esportazione.		Corda

  Resi:

  • Vedere Valori restituiti dal cmdlet

• Show-CvadAcDocument - Visualizza questa documentazione nel browser predefinito.

  Parametri:

  • Nessuno.

  Resi:

  • Visualizza questa pagina web nel browser web predefinito.

• Find-CvadAcInFile - Cerca nei file i componenti dei file YAML alla ricerca di membri che corrispondono a uno o più nomi che possono contenere caratteri jolly. Il risultato è un rapporto sui membri trovati. La funzione Trova nel file consente di cercare solo un componente alla volta. Trova nel file cerca tutti i file YAML nella cartella corrente e in tutte le sottocartelle. Utilizzare FindSourceFolder per limitare il numero di file da cercare.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Migrazione per componenti	Vedere Migrazione per componenti. Nota: il valore -All non è valido.		Parametri di commutazione
  IncludeByName	Un elenco che specifica i nomi dei gruppi di recapito da includere quando si imposta lo stato attivo del sito su attivo. Nei nomi sono supportati i caratteri jolly ‘*’ e ‘?’.		Elenco delle stringhe
  Unique	Segnala solo i membri trovati in modo univoco.		Parametro di commutazione
  IncludeYaml	Includere lo YAML specifico del membro.		Parametro di commutazione
  FindSourceFolder	La cartella find inizia la ricerca.		Corda
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		Parametro di commutazione
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione

  Ritorno:

  • Crea un report contenente i membri trovati per il componente specificato.

Cmdlet di attivazione del sito

Per ulteriori informazioni sull’attivazione dei siti e sull’utilizzo di questi cmdlet, vedere Attivazione dei siti.

• Set-CvadAcSiteActiveStateOnPrem - Imposta lo stato del sito locale su attivo o inattivo.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Parametri di accesso al cloud	Vedi Parametri di accesso al cloud		Parametri di commutazione
  SiteActive	Se presente, imposta il sito locale su attivo, rimuovendo la modalità di manutenzione da tutti i gruppi di distribuzione. Se questo parametro non è presente, la modalità di manutenzione viene impostata su tutti i gruppi di recapito.		Parametro di commutazione
  IncludeByName	Un elenco che specifica i nomi dei gruppi di recapito da includere quando si imposta lo stato attivo del sito su attivo. Nei nomi sono supportati i caratteri jolly ‘*’ e ‘?’.		Elenco delle stringhe
  ExcludeByName	Un elenco che specifica i nomi dei gruppi di recapito da escludere quando si imposta lo stato attivo del sito su attivo. Nei nomi sono supportati i caratteri jolly ‘*’ e ‘?’.		Elenco delle stringhe
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false

  Resi:

  • Vedere Valori restituiti dal cmdlet

• Set-CvadAcSiteActiveStateCloud - Imposta lo stato del sito cloud su attivo o inattivo.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  Parametri di accesso al cloud	Vedi Parametri di accesso al cloud		Parametri di commutazione
  SiteActive	Se presente, imposta il sito cloud su attivo, rimuovendo la modalità di manutenzione da tutti i gruppi di distribuzione. Se questo parametro non è presente, la modalità di manutenzione viene impostata su tutti i gruppi di recapito.		Parametro di commutazione
  IncludeByName	Un elenco che specifica i nomi dei gruppi di recapito da includere quando si imposta lo stato attivo del sito su attivo. Nei nomi sono supportati i caratteri jolly ‘*’ e ‘?’.		Elenco delle stringhe
  ExcludeByName	Un elenco che specifica i nomi dei gruppi di recapito da escludere quando si imposta lo stato attivo del sito su attivo. Nei nomi sono supportati i caratteri jolly ‘*’ e ‘?’.		Elenco delle stringhe
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione
  DisplayLog	Visualizza il file di registro al completamento del cmdlet. Impostare su $false per sopprimere la visualizzazione del registro.		$true or $false

  Resi:

  • Vedere Valori restituiti dal cmdlet

Unione di più cmdlet di siti on-premise

Per ulteriori informazioni sull’unione di siti e sull’utilizzo di questi cmdlet, vedere Unire più siti in un unico sito.

• New-CvadAcSiteMergingInfo - Crea un set di informazioni prefisso/suffisso di unione del sito. Non è necessario conoscere tutti i prefissi o suffissi all’inizio. Possono essere aggiornati con Set-CvadAcSiteMergingInfo oppure modificando manualmente il file SiteMerging.yml. Parametri:

  Nome	Descrizione	Necessario?	Tipo
  SiteName	Nome utilizzato per identificare l’insieme di prefissi/suffissi per un sito specifico. Può corrispondere al nome del sito effettivo, ma non è necessario.	X	Corda
  Parametri di unione del sito	Vedi Parametri di unione del sito		Parametri di commutazione
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione

  Resi:

  • Nessuno

• Set-CvadAcSiteMergingInfo - Aggiorna un set di informazioni di prefisso/suffisso di unione di siti esistente.

  Parametri:

  Nome	Descrizione	Necessario?	Tipo
  SiteName	Nome utilizzato per identificare l’insieme di prefissi/suffissi per un sito specifico. Può corrispondere al nome del sito effettivo, ma non è necessario.	X	Corda
  Parametri di unione del sito	Vedi Parametri di unione del sito		Parametri di commutazione
  Quiet	Sopprimi la registrazione sulla console.		Parametro di commutazione

  Resi:

  • Nessuno

• Remove-CvadAcSiteMergingInfo - Rimuove un set di informazioni di prefisso/suffisso di unione di siti esistente.

  Parametri:

  • SiteName – identifica l’insieme dei prefissi e suffissi del sito. Questa è una stringa ed è obbligatoria.

  Resi:

  • Nessuno

Parametri di unione del sito

I seguenti parametri possono essere utilizzati durante l’esecuzione dei cmdlet di unione dei siti. Tutti i parametri elencati sono stringhe.

• SiteName – il nome utilizzato per identificare l’insieme di prefissi/suffissi per un sito specifico. Può corrispondere al nome del sito effettivo, ma non è necessario. SiteName è un parametro obbligatorio.
• AdminScopedPrefix – il prefisso da applicare agli ambiti dell’amministratore.
• ApplicationPrefix - il prefisso da applicare alle applicazioni.
• ApplicationFolderPrefix – il prefisso da applicare alle cartelle dell’applicazione; ApplicationFolderPrefix può essere combinato con ApplicationFolderRoot.
• ApplicationFolderRoot – la nuova cartella radice delle cartelle dell’applicazione. In questo modo si crea una gerarchia di cartelle aggiuntiva. ApplicationFolderRoot può essere combinato con ApplicationFolderPrefix.
• ApplicationGroupPrefix – il prefisso per i gruppi di applicazioni.
• ApplicationUserPrefix – il prefisso da applicare al nome dell’applicazione visualizzato dall’utente.
• ApplicationAdminPrefix – il prefisso da applicare al nome dell’applicazione che l’amministratore vede.
• DeliveryGroupPrefix – il prefisso da applicare ai gruppi di consegna.
• GroupPolicyPrefix – il prefisso da applicare ai nomi dei criteri.
• HostConnectionPrefix – il prefisso da applicare alle connessioni host.
• MachineCatalogPrefix – il prefisso da applicare ai cataloghi delle macchine.
• StoreFrontPrefix – il prefisso da applicare ai nomi StoreFront.
• TagPrefix – il prefisso da applicare ai tag.
• AdminScopedSuffix – il suffisso da applicare agli ambiti dell’amministratore.
• ApplicationSuffix - il suffisso da applicare alle applicazioni.
• ApplicationFolderSuffix – il suffisso da applicare alle cartelle dell’applicazione; ApplicationFolderSuffix può essere combinato con ApplicationFolderRoot.
• ApplicationGroupSuffix – il suffisso per i gruppi di applicazioni.
• ApplicationUserSuffix – il suffisso da applicare al nome dell’applicazione visualizzato dall’utente.
• ApplicationAdminSuffix – il suffisso da applicare al nome dell’applicazione visualizzato dall’amministratore.
• DeliveryGroupSuffix – il suffisso da applicare ai gruppi di consegna.
• GroupPolicySuffix – il suffisso da applicare ai nomi delle policy.
• HostConnectionSuffix – il suffisso da applicare alle connessioni host.
• MachineCatalogSuffix – il suffisso da applicare ai cataloghi delle macchine.
• StoreFrontSuffix – il suffisso da applicare ai nomi StoreFront.
• TagSuffix – il suffisso da applicare ai tag.
• SiteRootFolder – il nome completo della cartella da utilizzare per esportazioni e importazioni; può essere una cartella locale o una condivisione file.

Parametri generici

Parametri di accesso al cloud

Tutti i cmdlet che accedono al cloud supportano i seguenti parametri aggiuntivi.

Nota:

CustomerId, ClientId e Secret possono essere inseriti nel file CustomerInfo.yml oppure specificati con il cmdlet utilizzando i seguenti parametri. Se specificati in entrambi i punti, i parametri del cmdlet hanno la precedenza.

• CustomerId – ID cliente utilizzato nelle API REST, necessario per accedere a tutte le API REST. Il tuo ID cliente si trova in Citrix Cloud.
• ClientId – Il clientID creato sul sito Web Citrix Cloud Identity and Access Management. Ciò è necessario per ottenere il token di trasporto necessario per l’autenticazione per tutte le API REST.
• Segreto – La chiave segreta creata sul sito Web Citrix Cloud Identity and Access Management. Ciò è necessario per ottenere il token di trasporto necessario per l’autenticazione per tutte le API REST.
• CustomerInfoFileSpec – La specifica del file che punta a un file di informazioni sul cliente per sovrascrivere il percorso e il nome predefiniti.

Parametri della modalità di migrazione

I cmdlet che modificano la configurazione del sito cloud (Import, Restore, Merge, Newe Sync) supportano i seguenti parametri aggiuntivi per fornire ulteriore flessibilità.

• CheckMode – Esegue l’operazione di importazione ma non apporta nessuna modifica. Tutte le modifiche previste vengono segnalate prima del completamento dell’importazione. È possibile utilizzare questo comando per testare l’importazione prima che venga eseguita.
• BackupFirst – Esegue il backup del contenuto del cloud in file .yml prima di modificare la configurazione del cloud. Questa opzione è abilitata per impostazione predefinita.
• Conferma – Se vero, chiede agli utenti di confermare che desiderano apportare modifiche alla configurazione del sito cloud. Il cmdlet Remove mostra un prompt a causa della sua natura distruttiva. Impostare su false se non si desidera alcuna richiesta, ad esempio l’esecuzione all’interno di script automatizzati. Conferma il valore predefinito è vero.
• SecurityFileFolder – Questa è la cartella completamente qualificata contenente il file CustomerInfo.yml che potrebbe puntare a una cartella locale o a una cartella di condivisione di rete che potrebbe essere sottoposta a controllo di autenticazione. Lo strumento non richiederà credenziali; prima di eseguire lo strumento è necessario ottenere l’accesso alla risorsa controllata.
• SiteName – Specifica il set di prefissi e suffissi di unione dei siti da utilizzare durante l’importazione.
• SiteActive – Specifica se il sito importato è attivo o inattivo. Per impostazione predefinita, questo parametro è impostato su $false , il che significa che il sito importato è inattivo.

Parametri di visualizzazione del registro

I cmdlet Esporta, Importa, Sincronizza, Ripristina, Backup, Confrontae Rimuovi visualizzano il file di registro al termine dell’operazione. È possibile sopprimere la visualizzazione impostando il parametro -DisplayLog su $false. Notepad.exe viene utilizzato per impostazione predefinita per visualizzare il file di registro. È possibile specificare un editor diverso nel file CustomerInfo.yml.

Editor: C:\Program Files\Notepad++\notepad++.exe

Valori restituiti dai cmdlet

AzioneRisultato

Tutti i cmdlet restituiscono il seguente valore.

              public class ActionResult
              {
                  public bool                         Overall_Success;
                  public Dictionary<string, string>   Individual_Success;
                  public object                       CustomResult;
              }

Overall_Success restituisce un singolo valore booleano che mostra il successo complessivo del cmdlet in tutti i componenti selezionati: true significa riuscito e false significa non riuscito.

Individual_Success restituisce uno o tre valori per ciascun componente principale. Il risultato di un componente può essere Riuscito, Fallito o Saltato. Ignorato indica che il componente non è stato selezionato per l’esecuzione dal cmdlet.

CustomResult è specifico del cmdlet.

Risultato personalizzato

Importa, Unisci, Ripristina, Sincronizza, Confronta, Confronta filee Rimuovi restituiscono le seguenti informazioni sui risultati personalizzati a una singola istanza di EvaluationResultData.

Nota:

I cmdlet Export e Template non restituiscono un risultato personalizzato.

                  public class EvaluationResultData
                  {
                      public Dictionary<string, Dictionary<string, ActionResultValues >> EvaluationResults;
                      public int                  Added;
                      public int                  Updated;
                      public int                  Deleted;
                      public int                  NoChange;
                      public int                  TotalChanged;
                      public EvaluationResults     OverallResult;
                      public string               CloudBackupFolder;
                      public string               SourceBackupFolder;
                  }
                  Where:
                  public enum ActionResultValues
                 {
                      Add,
                      Update,
                      Delete,
                      Identical,
                      DoNothing
                  }
                  public enum EvaluationResults
                  {
                      Success,
                      Failure,
                      Skipped
                  }

EvaluationResults visualizza un elenco con una voce per componente selezionato. La chiave è il nome del componente e il valore è un elenco di ciascun membro del componente e dell’azione eseguita su quel membro del componente. Le azioni possono essere uno qualsiasi dei valori ActionResultValues .

Aggiunti, Aggiornati, Eliminatie NoChange indicano il numero totale di membri del componente aggiunti, aggiornati, eliminati o per i quali non è stata intrapresa alcuna azione, in quest’ordine.

TotalChanged è la somma di Aggiunti, Aggiornatie Eliminati.

OverallResult è un singolo valore booleano che indica il risultato del cmdlet. Vero indica il successo totale in tutti i componenti, mentre falso indica il fallimento nell’elaborazione di uno o più componenti.

CloudBackupFolder è la specifica del file completamente qualificata del backup della configurazione del sito cloud prima che il cmdlet esegua azioni di modifica del cloud.

SourceBackupFolder è la specifica del file completamente qualificata del backup del file di origine eseguito dopo il completamento del cmdlet. Per impostazione predefinita, questi file si trovano in %HOMEPATH%\Documents\Citrix\AutoConfig.

Guida di PowerShell

Per ogni cmdlet è disponibile la guida di PowerShell. Tutti i parametri sono documentati con ciascun cmdlet insieme a una breve spiegazione del cmdlet. Per accedere alla guida per qualsiasi cmdlet, digitare Get-Help davanti al cmdlet.

Get-Help Import-CvadAcToSite