Cmdlets da ferramenta de configuração automatizada
Esta página lista todos os cmdlets e parâmetros suportados pela ferramenta.
Todos os cmdlets adotam parâmetros com um dos seguintes tipos.
- Cadeia de caracteres
- Lista de cadeias de caracteres
- Booleano:
$true
ou$false
- SwitchParameter: presença das médias dos parâmetros
$true
; ausência das médias dos parâmetros$false
Nota:
SwitchParameter é o método preferido para seleções verdadeiras ou falsas, mas os booleanos ainda são usados na ferramenta devido a problemas de legado.
A tabela a seguir é um resumo de todos os cmdlets. Consulte cada seção individual para descobrir quais parâmetros cada cmdlet oferece suporte.
Categoria | Cmdlet | Descrição |
---|---|---|
Migração de local para nuvem | Export-CvadAcToFile |
Exportar arquivos locais para arquivos YAML. |
Import-CvadAcToSite |
||
Merge-CvadAcToSite |
||
New-CvadAcToSite |
||
Sync-CvadAcToSite |
||
Migração granular No caso de componentes, use parâmetros com os comandos acima. Exemplos: MachineCatalogs , Tags . No caso de nomes de componentes, use parâmetros com os comandos acima. Exemplos: IncludeByName , ExcludeByName . |
||
Cmdlets de nuvem para nuvem | Backup-CvadAcToFile |
Faz backup de toda a configuração do seu site na nuvem. |
Restore-CvadAcToSite |
||
Remove-CvadAcFromSite |
||
Migração granular No caso de componentes, use parâmetros com os comandos acima. Exemplos: MachineCatalogs , Tags . No caso de nomes de componentes, use parâmetros com os comandos acima. Exemplos: IncludeByName , ExcludeByName . |
||
Outros cmdlets básicos | Compare-CvadAcToSite |
Compara os arquivos .yml locais com a configuração da nuvem. |
Cmdlets relacionados a pré-requisitos | New-CvadAcCustomerInfoFile |
Criar um arquivo de informações do consumidor. |
Set-CvadAcCustomerInfoFile |
||
Cmdlets de suporte e solução de problemas | New-CvadAcZipInfoForSupport |
Compacta todos os arquivos de log e .yml em um único arquivo zip para enviar à Citrix para suporte. |
Get-CvadAcStatus |
||
Test-CvadAcConnectionWithSite |
||
Find-CvadAcConnector |
||
Get-CvadAcCustomerSites |
||
New-CvadAcTemplateToFile |
||
Show-CvadAcDocument |
||
Find-CvadAcInFile |
||
Cmdlets de ativação do site | Set-CvadAcSiteActiveStateOnPrem |
Define o estado do site local como ativo ou inativo. |
Set-CvadAcSiteActiveStateCloud |
||
Mesclagem de vários cmdlets de sites locais | New-CvadAcSiteMergingInfo |
Cria um conjunto de informações de prefixo/sufixo de mesclagem de sites. |
Set-CvadAcSiteMergingInfo |
||
Remove-CvadAcSiteMergingInfo |
Para obter mais informações sobre parâmetros e como usá-los, consulte Parâmetros de migração granular.
Cmdlets básicos
Cmdlets locais para a nuvem
-
Export-CvadAcToFile
- Exportar arquivos locais para arquivos YAML.Exporta a configuração da configuração local. Essa é a operação de exportação padrão para a Configuração automatizada. Nenhuma modificação é feita na configuração do site local. Os arquivos exportados são colocados no diretório %HOMEPATH%\Documents\Citrix\AutoConfig em uma subpasta Export com nome exclusivo. A pasta %HOMEPATH%\Documents\Citrix\AutoConfig sempre contém a configuração de site local exportada mais recente.
Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes SwitchParameters Filtrar por nomes de objetos Consulte Filtragem por nomes de objetos Lista de cadeias de caracteres TargetFolder
Especifica a pasta de destino da exportação. Cadeia de caracteres Locale
Especifica o idioma do texto legível por seres humanos que pode ser exportado. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter AdminAddress
Especifica o DNS ou o endereço IP do Delivery Controller quando a exportação não está sendo executada no Controlador de Entrega. Cadeia de caracteres CheckUserAndMachines
Verifica se os usuários e as máquinas estão no Active Directory. Usuários e máquinas que não estão no Active Directory podem resultar em falhas de importação. $true
ou$false
ZipResults
Compacta o backup de arquivos YAML em um único arquivo zip. O arquivo está na mesma pasta que os arquivos YAML de backup e tem o mesmo nome da pasta. SwitchParameter Retorna:
- Consulte Valores de retorno do cmdlet
Existem três maneiras de importar dados para a nuvem. A execução de cmdlets específicos pode resultar em uma das três combinações de ações no site da nuvem:
- Adicionar, atualizar e excluir
- Adicionar e atualizar somente
- Adicionar apenas
Cmdlet | Adicionar | Atualizar | Delete |
---|---|---|---|
Importar | X | X | X |
Mesclar | X | X | |
Novo | X |
-
Import-CvadAcToSite
- Importar arquivos YAML para a nuvem. Suporta operações de criação, atualização e exclusão.Importa todos os arquivos locais para a nuvem. Esse comando garante que o estado final da nuvem seja idêntico ao estado local. Essa opção exclui todas as alterações existentes na nuvem. Os arquivos de configuração de site importados são provenientes de %HOMEPATH%\Documents\Citrix\AutoConfig. Use com cuidado.
Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes. SwitchParameters Filtrar por nomes de objetos Consulte Filtragem por nomes de objetos. Lista de cadeias de caracteres Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem. SwitchParameters SourceFolder
Identifica uma pasta raiz substituta para %HOMEPATH%\Documents\Citrix\AutoConfig. Cadeia de caracteres Locale
Especifica o idioma do texto legível por seres humanos que pode ser exportado. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true
ou$false
Merge
Quando definido como $true
, só adiciona componentes ao site da nuvem. Os componentes não são removidos. Defina como$false
para remover componentes.$true
ou$false
AddOnly
Quando definido como $true
, adiciona apenas novos componentes, não atualiza nem exclui componentes existentes. Defina como$false
para permitir atualizações e exclusões.Merge
é ignorado quando esse parâmetro é$true
.$true
ou$false
MergePolicies
Mesclar configurações de política e filtros. A mesclagem ocorre somente quando uma política que está sendo importada já existe no DDC da nuvem. O resultado da mesclagem de políticas é que as políticas de nuvem DDC contêm as configurações e os filtros que já tinham, além das novas configurações e filtros que estão sendo importados. Observe que, quando ocorrem colisões de configuração e filtro, os valores importados têm precedência. SwitchParameter OnErrorAction
Consulte Parâmetro OnErrorAction. Cadeia de caracteres Retorna:
- Consulte Valores de retorno do cmdlet
-
Merge-CvadAcToSite
- Importar arquivos YAML para a nuvem. Oferece suporte a operações de criação e atualização.Mescla os arquivos locais com a nuvem, mas não exclui nenhum componente na nuvem ou no site local. Isso preserva as alterações já feitas na nuvem. Se existir um componente no Citrix Cloud com o mesmo nome, esse comando poderá modificar esse componente. Essa é a operação de importação padrão para a Configuração automatizada. Os arquivos de configuração de site mesclados são provenientes de %HOMEPATH%\Documents\Citrix\AutoConfig.
Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes. SwitchParameters Filtrar por nomes de objetos Consulte Filtragem por nomes de objetos. Lista de cadeias de caracteres Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem. SwitchParameters SourceFolder
Identifica uma pasta raiz substituta para %HOMEPATH%\Documents\Citrix\AutoConfig. Cadeia de caracteres Locale
Especifica o idioma do texto legível por seres humanos que pode ser exportado. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true
ou$false
Merge
Quando definido como $true
, só adiciona componentes ao site da nuvem. Os componentes não são removidos. Defina como$false
para remover componentes.$true
ou$false
AddOnly
Quando definido como $true
, adiciona apenas novos componentes, não atualiza nem exclui componentes existentes. Defina como$false
para permitir atualizações e exclusões.Merge
é ignorado quando esse parâmetro é$true
.$true
ou$false
MergePolicies
Mesclar configurações de política e filtros. A mesclagem ocorre somente quando uma política que está sendo importada já existe no DDC da nuvem. O resultado da mesclagem de políticas é que as políticas de nuvem DDC contêm as configurações e os filtros que já tinham, além das novas configurações e filtros que estão sendo importados. Observe que, quando ocorrem colisões de configuração e filtro, os valores importados têm precedência. SwitchParameter OnErrorAction
Consulte Parâmetro OnErrorAction. Cadeia de caracteres Retorna:
- Consulte Valores de retorno do cmdlet
-
New-CvadAcToSite
- Importar arquivos YAML para a nuvem. Oferece suporte a operações de criação e atualização.Importa a configuração do site local para a nuvem, mas adiciona apenas novos componentes. Os componentes existentes do site na nuvem não são atualizados nem excluídos. Use esse comando se for necessário que os componentes do site de nuvem existentes permaneçam inalterados.
Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes. SwitchParameters Filtrar por nomes de objetos Consulte Filtragem por nomes de objetos. Lista de cadeias de caracteres Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem. SwitchParameters SourceFolder
Identifica uma pasta raiz substituta para %HOMEPATH%\Documents\Citrix\AutoConfig. Cadeia de caracteres Locale
Especifica o idioma do texto legível por seres humanos que pode ser exportado. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true
ou$false
OnErrorAction
Consulte Parâmetro OnErrorAction. Cadeia de caracteres Retorna:
- Consulte Valores de retorno do cmdlet
-
Sync-CvadAcToSite
- Exportar e importar em uma única etapa.A sincronização executa a exportação e a importação em uma única etapa. Use o parâmetro
SourceTargetFolder
para especificar a pasta de destino de exportação/importação.Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes SwitchParameters Filtrar por nomes de objetos Consulte Filtragem por nomes de objetos Lista de cadeias de caracteres Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem SwitchParameters SourceTargetFolder
Especifica a pasta de destino de exportação/importação. Cadeia de caracteres Locale
Especifica o idioma do texto legível por seres humanos que pode ser exportado. Cadeia de caracteres AdminAddress
Especifica o DNS ou o endereço IP do controlador de entrega quando a exportação não está sendo executada no controlador de entrega. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true
ou$false
Merge
Quando definido como $true
, só adiciona componentes ao site da nuvem. Os componentes não são removidos. Defina como$false
para remover componentes.$true
ou$false
AddOnly
Quando definido como $true
, adiciona apenas novos componentes, não atualiza nem exclui componentes existentes. Defina como$false
para permitir atualizações e exclusões.Merge
é ignorado quando esse parâmetro é$true
.$true
ou$false
MergePolicies
Mesclar configurações de política e filtros. A mesclagem ocorre somente quando uma política que está sendo importada já existe no DDC da nuvem. O resultado da mesclagem de políticas é que as políticas de nuvem DDC contêm as configurações e os filtros que já tinham, além das novas configurações e filtros que estão sendo importados. Observe que, quando ocorrem colisões de configuração e filtro, os valores importados têm precedência. SwitchParameter Retorna:
- Consulte Valores de retorno do cmdlet
Cmdlets de nuvem para nuvem
-
Backup-CvadAcToFile
- Faz backup de toda a configuração do seu site na nuvem.Exporta a configuração da nuvem para arquivos .yml. Esse backup pode ser usado em um processo de backup e restauração para restaurar componentes perdidos.
Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes SwitchParameters Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem SwitchParameters TargetFolder
Especifica a pasta de destino da exportação. Cadeia de caracteres Locale
Especifica o idioma do texto legível por seres humanos que pode ser exportado. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true
ou$false
ZipResults
Compacta o backup de arquivos YAML em um único arquivo zip. O arquivo está na mesma pasta que os arquivos YAML de backup e tem o mesmo nome da pasta. SwitchParameter Retorna:
- Consulte Valores de retorno do cmdlet
-
Restore-CvadAcToSite
- Restaura arquivos YAML de backup para o site da nuvem. Esse site na nuvem pode ser igual ou diferente do site de nuvem de origem.Restaura o site da nuvem para a configuração anterior. Os arquivos importados são originados da pasta especificada usando o parâmetro
-RestoreFolder
, que identifica a pasta que contém os arquivos .yml que devem ser restaurados no site da nuvem. Essa deve ser uma especificação de pasta totalmente qualificada. Esse cmdlet pode ser usado para reverter para a configuração anterior ou para fazer backup e restaurar seu site na nuvem. Esse comando pode adicionar, excluir e atualizar seu site na nuvem.Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes. SwitchParameters Filtrar por nomes de objetos Consulte Filtragem por nomes de objetos. Lista de cadeias de caracteres Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem. SwitchParameters RestoreFolder
Identifica a pasta que contém os arquivos .yml que devem ser restaurados no site da nuvem. Essa deve ser uma especificação de pasta totalmente qualificada. Cadeia de caracteres Locale
Especifica o idioma do texto legível por seres humanos que pode ser exportado. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true
ou$false
Merge
Quando definido como $true
, só adiciona componentes ao site da nuvem. Os componentes não são removidos. Defina como$false
para remover componentes.$true
ou$false
AddOnly
Quando definido como $true
, adiciona apenas novos componentes, não atualiza nem exclui componentes existentes. Defina como$false
para permitir atualizações e exclusões.Merge
é ignorado quando esse parâmetro é$true
.$true
ou$false
MergePolicies
Mesclar configurações de política e filtros. A mesclagem ocorre somente quando uma política que está sendo importada já existe no DDC da nuvem. O resultado da mesclagem de políticas é que as políticas de nuvem DDC contêm as configurações e os filtros que já tinham, além das novas configurações e filtros que estão sendo importados. Observe que, quando ocorrem colisões de configuração e filtro, os valores importados têm precedência. SwitchParameter OnErrorAction
Consulte Parâmetro OnErrorAction. Cadeia de caracteres Retorna:
- Consulte Valores de retorno do cmdlet
-
Remove-CvadAcFromSite
— Remover membros do componente da nuvem.Pode redefinir o site inteiro ou remover itens de membro de um componente (por exemplo, remover um catálogo de máquina da lista de catálogos). Isso pode ser usado quando acoplado ao parâmetro
IncludeByName
para remover seletivamente membros específicos.Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes SwitchParameters Filtrar por nomes de objetos Consulte Filtragem por nomes de objetos Lista de cadeias de caracteres Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem SwitchParameters Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true
ou$false
Retorna:
- Consulte Valores de retorno do cmdlet
Outros cmdlets básicos
-
Compare-CvadAcToSite
- Compara os arquivos .yml locais com a configuração da nuvem, produzindo um relatório de alterações feitas por um cmdletImport
,Merge
ouRestore
.Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes. SwitchParameters Filtrar por nomes de objetos Consulte Filtragem por nomes de objetos. Lista de cadeias de caracteres Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem. SwitchParameters SourceFolder
Identifica uma pasta raiz substituta para %HOMEPATH%\Documents\Citrix\AutoConfig. Cadeia de caracteres Locale
Especifica o idioma do texto legível por seres humanos que pode ser exportado. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true
ou$false
Merge
Quando definido como $true
, só adiciona componentes ao site da nuvem. Os componentes não são removidos. Defina como$false
para remover componentes.$true
ou$false
AddOnly
Quando definido como $true
, adiciona apenas novos componentes, não atualiza nem exclui componentes existentes. Defina como$false
para permitir atualizações e exclusões.Merge
é ignorado quando esse parâmetro é$true
.$true
ou$false
OnErrorAction
Consulte Parâmetro OnErrorAction. Cadeia de caracteres Retorna:
- Consulte Valores de retorno do cmdlet
Parâmetros de migração granular
Migrar por componentes
Os seguintes componentes podem ser especificados com cmdlets que os suportam. A opção All
é selecionada automaticamente quando não é especificado nenhum parâmetro de componente. Para evitar erros, recomendamos que você migre os componentes na seguinte ordem:
All
Tags
AdminRoles
AdminScopes
HostConnections
MachineCatalogs
StoreFronts
DeliveryGroups
ApplicationGroups
ApplicationFolders
Applications
GroupPolicies
UserZonePreference
Filtrar por nomes de objetos
Migrar por nomes de componentes
Os ExcludeByName
parâmetros IncludeByName
e permitem incluir e excluir membros de componentes em cmdlets por nome. Apenas um componente (por exemplo, grupos de entrega) pode ser escolhido por vez em qualquer um dos cmdlets suportados. Se um membro do componente estiver em ambas as áreas, a exclusão substituirá qualquer outro parâmetro e será criada uma entrada na lista de correção de log para identificar o componente e o nome do membro que foi excluído.
IncludeByName
e ExcludeByName
obtêm uma lista de nomes de membros de componentes. Qualquer nome pode conter um ou mais curingas. Dois tipos de curingas têm suporte. A lista de nomes de membros de componentes deve estar entre aspas simples quando qualquer nome de membro contiver caracteres especiais.
- * Corresponde a qualquer número de caracteres
- ? Corresponde a um único caractere
IncludeByName
e ExcludeByName
também podem obter um arquivo que contém uma lista de membros em que cada membro pode ser explícito ou conter curingas. Cada linha do arquivo pode conter um membro. Os espaços à esquerda e à direita são cortados do nome do membro. O nome do arquivo deve ser precedido pelo sinal @ e estar entre aspas simples (um requisito do PowerShell para que o @ não seja reinterpretado). Podem ser listados vários arquivos, que também podem ser misturados com nomes de membros.
Um exemplo de mesclagem de todos os grupos de entrega cujos nomes começam com DgSite1
e contêm Home2
seria escrito:
Merge-CvadAcToSite –DeliveryGroups –IncludeByName DgSite1*,*Home2*
Por nome do grupo de entrega
ByDeliveryGroupName
filtra pelo nome do grupo de entrega para aplicativos e grupos de aplicativos. Esse parâmetro é sempre uma lista de inclusão que identifica os membros a serem incluídos com base na associação do grupo de entrega.
ByDeliveryGroupName
pega uma lista de nomes de grupos de entrega. Qualquer nome pode conter um ou mais curingas. Dois tipos de curingas têm suporte.
- * corresponde a qualquer número de caracteres
- ? corresponde a um único caractere
O exemplo a seguir mescla todos os aplicativos que fazem referência a todos os nomes de grupos de entrega que começam com EastDg
.
Merge-CvadAcToSite –Applications –ByDeliveryGroupName EastDg*
Excluir desativado
ExcludeDisabled
filtra das operações de importação todos os aplicativos e grupos de aplicativos que estão desativados. ExcludeDisabled
passa para o valor padrão false
, o que significa que todos os aplicativos e grupos de aplicativos são importados independentemente do estado ativado.
Por nome de máquina
ByMachineName
filtra pelo nome da máquina para catálogos de máquinas e grupos de entrega. Esse parâmetro é sempre uma lista de inclusão que identifica os membros a serem incluídos com base na associação de nomes de máquinas.
ByMachineName
usa uma lista de nomes de máquinas em que qualquer nome pode conter um ou mais curingas. Dois tipos de curingas têm suporte.
- * corresponde a qualquer número de caracteres
- ? corresponde a um único caractere
Ao exportar ou importar e usar ByMachineName
e um filtro de nome de máquina não resultar em máquinas no catálogo de máquinas ou no grupo de entrega, o catálogo de máquinas ou o grupo de entrega é excluído da exportação ou importação.
Nota:
O uso de
ByMachineName
em qualquer tipo de cmdlet de importação resulta emMergeMachines
definido como$true
.
Mesclar máquinas
MergeMachines
, quando definido como $true
, instrui a operação de importação a adicionar máquinas somente ao catálogo de máquinas ou ao grupo de entrega. As máquinas não são removidas, permitindo operações aditivas incrementais.
MergeMachines
o padrão é falso, o que significa que as máquinas são removidas se não estiverem presentes no catálogo de máquinas ou no arquivo .yml do grupo de entrega. MergeMachines
está definido como $true
quando ByMachineName
é usado, mas pode ser substituído definindo como MergeMachines
false.
Cmdlets relacionados a pré-requisitos
-
New-CvadAcCustomerInfoFile
- Crie um arquivo de informações do consumidor. Por padrão, o arquivo de informações do consumidor está localizado em %HOMEPATH%\Documents\Citrix\AutoConfig.Parâmetros:
Nome Descrição Obrigatório? Tipo CustomerId
ID do consumidor. x Cadeia de caracteres ClientId
ID de consumidor do consumidor criado no Citrix Cloud. O CustomerID e o Secret devem ser especificados ao usar esse parâmetro. Condicionalmente Cadeia de caracteres Secret
Chave secreta do consumidor criada no Citrix Cloud. O CustomerID e o ClientID devem ser especificados ao usar esse parâmetro. Condicionalmente Cadeia de caracteres Environment
Ambiente Production, ProductionGov ou ProductionJP. Enumeração LogFileName
Altere o prefixo do arquivo de log do CitrixLog para outra coisa. Cadeia de caracteres AltRootUrl
Use somente sob a direção da Citrix. Cadeia de caracteres StopOnError
Interrompe a operação no primeiro erro. $true
ou$false
TargetFolder
Use a pasta especificada como a pasta raiz em vez de %HOMEPATH%\Documents\Citrix\AutoConfig. Cadeia de caracteres Locale
Use o local especificado em vez da localidade derivada do sistema em que a ferramenta é executada. Cadeia de caracteres Editor
Use o editor especificado para exibir o log na conclusão de cada cmdlet. O Notepad.exe é o editor padrão. Esse parâmetro deve incluir a especificação de arquivo totalmente qualificada para o editor e o editor deve tomar a especificação do arquivo de log como seu único parâmetro. Cadeia de caracteres SecurityCsvFileSpec
A especificação de arquivo totalmente qualificada que aponta para o arquivo SecurityClient.csv baixado do Citrix Identity and Access Management. O CustomerID deve ser especificado quando esse parâmetro é usado. Cadeia de caracteres Retorna:
- Consulte Valores de retorno do cmdlet
-
Set-CvadAcCustomerInfoFile
- Atualize um arquivo de informações do consumidor existente. Somente os parâmetros especificados pelo cmdlet são alterados. Todos os valores de parâmetros não especificados no arquivo CustomerInfo.yml permanecem inalterados.Parâmetros:
Nome Descrição Obrigatório? Tipo CustomerId
ID do consumidor. Cadeia de caracteres ClientId
ID de consumidor do consumidor criado no Citrix Cloud. Cadeia de caracteres Secret
Chave secreta do consumidor criada no Citrix Cloud. Cadeia de caracteres Environment
Ambiente Production, ProductionGov ou ProductionJP. Enumeração LogFileName
Altere o prefixo do arquivo de log do CitrixLog para outra coisa. Cadeia de caracteres StopOnError
Interrompe a operação no primeiro erro. $true
ou$false
TargetFolder
Use a pasta especificada como a pasta raiz em vez de %HOMEPATH%\Documents\Citrix\AutoConfig. Cadeia de caracteres Locale
Use o local especificado em vez da localidade derivada do sistema em que a ferramenta é executada. Cadeia de caracteres Editor
Use o editor especificado para exibir o log na conclusão de cada cmdlet. O Notepad.exe é o editor padrão. Esse parâmetro deve incluir a especificação de arquivo totalmente qualificada para o editor e o editor deve tomar a especificação do arquivo de log como seu único parâmetro. Cadeia de caracteres SecurityCsvFileSpec
A especificação de arquivo totalmente qualificada que aponta para o arquivo SecurityClient.csv baixado do Citrix Identity and Access Management. O CustomerID deve ser especificado quando esse parâmetro é usado. Cadeia de caracteres Retorna:
- Consulte Valores de retorno do cmdlet
Parâmetros relacionados aos pré-requisitos
Junto com os parâmetros de acesso à nuvem, os seguintes parâmetros podem ser usados com os cmdlets relacionados aos pré-requisitos:
-
Environment
– Ambiente Production ou ProductionGov. -
LogFileName
– Altere o prefixo do arquivo de log do CitrixLog para outra coisa. -
StopOnError
– Interrompe a operação no primeiro erro. -
AlternateRootFolder
– Usar a pasta especificada como a pasta raiz em vez de %HOMEPATH%\Documents\Citrix\AutoConfig. -
Locale
– Usar o local especificado em vez da localidade derivada do sistema em que a ferramenta é executada. -
Editor
– Usar o editor especificado para exibir o log na conclusão de cada cmdlet. O Notepad.exe é o editor padrão. Esse parâmetro deve incluir a especificação de arquivo totalmente qualificada para o editor e o editor deve tomar a especificação do arquivo de log como seu único parâmetro.
Cmdlets de suporte e solução de problemas
-
New-CvadAcZipInfoForSupport
- Compacta todos os arquivos de log e .yml em um único arquivo zip para enviar à Citrix para suporte. Informações confidenciais do consumidor (CustomerInfo.yml e CvadAcSecurity.yml) não estão incluídas no zip. O arquivo Icon.yml também é excluído devido ao seu tamanho. O arquivo zip é colocado em %HOMEPATH%\Documents\Citrix\AutoConfig e nomeado CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip, com base na data e no carimbo de data/hora. Esse arquivo zip também pode funcionar como um backup.Parâmetros:
Nome Descrição Obrigatório? Tipo TargetFolder
Especifica uma pasta de destino para criar e salvar o arquivo zip. Cadeia de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter Retorna:
- O arquivo zip com o nome e a localização é exibido no prompt de comando.
-
Get-CvadAcStatus
- Use para testar a conectividade e garantir que todos os pré-requisitos sejam atendidos. Retorna informações sobre a ferramenta, como número da versão e conectividade com a nuvem e o status do conector.Parâmetros:
Nome Descrição Obrigatório? Tipo Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem SwitchParameters SiteId
Identifica o site ao qual se conectar. Cadeia de caracteres AdminAddress
Este é o endereço DNS ou IP do Delivery Controller local usado para verificar o nível de acesso do administrador. Isso é necessário se a ferramenta não estiver sendo executada em um Delivery Controller. Cadeia de caracteres Retorna:
- Exibe os resultados de cada item.
-
Test-CvadAcConnectionWithSite
— Teste a conexão com o site da nuvem para verificar se a conexão de comunicação está funcionando. Esse cmdlet usa os parâmetros de acesso à nuvem ou o arquivo CustomerInfo.yml para especificar as informações de conexão do consumidor.Parâmetros:
Nome Descrição Obrigatório? Tipo Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem SwitchParameters Quiet
Suprimir o registro em log no console. SwitchParameter Retorna:
- Os resultados do teste são exibidos na linha de comando.
-
Find-CvadAcConnector
- Localiza os conectores existentes e determina seu estado de execução. Esse cmdlet usa informações do arquivo CustomerInfo.yml ou do parâmetro de ID do cliente para localizar os conectores do consumidor.Parâmetros:
Nome Descrição Obrigatório? Tipo CustomerInfoFileSpec
A especificação do arquivo que aponta para um arquivo de informações do consumidor para substituir o local e o nome padrão. Esse parâmetro é ignorado quando é fornecido o parâmetro CustomerId
.Cadeia de caracteres CustomerId
O ID do consumidor. Esse parâmetro substitui o mesmo valor no arquivo CustomerInfo.yml. Cadeia de caracteres Retorna:
- Os resultados são mostrados na linha de comando.
-
Get-CvadAcCustomerSites
- Retorna a lista de todos os sites dos consumidores. Esse cmdlet usa os parâmetros de acesso à nuvem ou o arquivo CustomerInfo.yml para especificar as informações de conexão do consumidor.Parâmetros:
- Consulte Parâmetros de acesso à nuvem
Retorna:
- Exibe uma lista de IDs de sites de consumidor encontrados.
-
New-CvadAcTemplateToFile
– Cria um arquivo de modelo para componentes selecionados, permitindo que você crie manualmente um arquivo de importação.Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes SwitchParameters TargetFolder
Especifica a pasta de destino da exportação. Cadeia de caracteres Retorna:
- Consulte Valores de retorno do cmdlet
-
Show-CvadAcDocument
- Exibe esta documentação no navegador padrão.Parâmetros:
- Nenhuma.
Retorna:
- Exibir esta página da Web no navegador da Web padrão.
-
Find-CvadAcInFile
- Encontrar no componente de pesquisas de arquivos YAML procurando membros que correspondam a um ou mais nomes que possam conter curingas. O resultado é um relatório de membros encontrados. Localizar no arquivo só pode pesquisar um componente por vez. Localizar no arquivo pesquisa todos os arquivos YAML na pasta atual e em todas as subpastas. UseFindSourceFolder
para limitar o número de arquivos a serem pesquisados.Parâmetros:
Nome Descrição Obrigatório? Tipo Migrar por componentes Consulte Migrar por componentes. Nota: O valor -All
não é válido.SwitchParameters IncludeByName
Uma lista que especifica os nomes dos grupos de entrega que devem ser incluídos ao definir o estado ativo do site como ativo. Os caracteres curinga ‘*’ e ‘?’ são suportados em nomes. Lista de cadeias de caracteres Unique
Indicar apenas membros encontrados exclusivamente. SwitchParameter IncludeYaml
Inclua o YAML específico do membro. SwitchParameter FindSourceFolder
A pasta em que a função de busca começa. Cadeia de caracteres DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.SwitchParameter Quiet
Suprimir o registro em log no console. SwitchParameter Retorno:
- Cria um relatório que contém membros encontrados para o componente especificado.
Cmdlets de ativação do site
Para obter mais informações sobre a ativação de sites e o uso desses cmdlets, consulte Ativação de sites.
-
Set-CvadAcSiteActiveStateOnPrem
- Define o estado do site local como ativo ou inativo.Parâmetros:
Nome Descrição Obrigatório? Tipo Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem SwitchParameters SiteActive
Quando presente, define o site local como ativo removendo o modo de manutenção de todos os grupos de entrega. Quando esse parâmetro não está presente, o modo de manutenção é definido em todos os grupos de entrega. SwitchParameter IncludeByName
Uma lista que especifica os nomes dos grupos de entrega que devem ser incluídos ao definir o estado ativo do site como ativo. Os caracteres curinga ‘*’ e ‘?’ são suportados em nomes. Lista de cadeias de caracteres ExcludeByName
Uma lista que especifica os nomes dos grupos de entrega que devem ser excluídos ao definir o estado ativo do site como ativo. Os caracteres curinga ‘*’ e ‘?’ são suportados em nomes. Lista de cadeias de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true or $false
Retorna:
- Consulte Valores de retorno do cmdlet
-
Set-CvadAcSiteActiveStateCloud
- Define o estado do site da nuvem como ativo ou inativo.Parâmetros:
Nome Descrição Obrigatório? Tipo Parâmetros de acesso à nuvem Consulte Parâmetros de acesso à nuvem SwitchParameters SiteActive
Quando presente, define o site na nuvem como ativo removendo o modo de manutenção de todos os grupos de entrega. Quando esse parâmetro não está presente, o modo de manutenção é definido em todos os grupos de entrega. SwitchParameter IncludeByName
Uma lista que especifica os nomes dos grupos de entrega que devem ser incluídos ao definir o estado ativo do site como ativo. Os caracteres curinga ‘*’ e ‘?’ são suportados em nomes. Lista de cadeias de caracteres ExcludeByName
Uma lista que especifica os nomes dos grupos de entrega que devem ser excluídos ao definir o estado ativo do site como ativo. Os caracteres curinga ‘*’ e ‘?’ são suportados em nomes. Lista de cadeias de caracteres Quiet
Suprimir o registro em log no console. SwitchParameter DisplayLog
Exibe o arquivo de log quando o cmdlet é concluído. Defina como $false
para suprimir a exibição do log.$true or $false
Retorna:
- Consulte Valores de retorno do cmdlet
Mesclagem de vários cmdlets de sites locais
Para obter mais informações sobre a mesclagem de sites e o uso desses cmdlets, consulte Mesclar vários sites em um único site.
-
New-CvadAcSiteMergingInfo
- Cria um conjunto de informações de prefixo/sufixo de mesclagem de sites. Não é necessário conhecer todos os prefixos ou sufixos no início. Eles podem ser atualizados comSet-CvadAcSiteMergingInfo
ou editando manualmente o arquivo SiteMerging.yml. Parâmetros:Nome Descrição Obrigatório? Tipo SiteName
O nome usado para identificar o conjunto de prefixos/sufixos para um site específico. Ele pode corresponder ao nome do site real, mas não obrigatoriamente. x Cadeia de caracteres Parâmetros de fusão do site Consulte Parâmetros de fusão do site SwitchParameters Quiet
Suprimir o registro em log no console. SwitchParameter Retorna:
- Nenhuma
-
Set-CvadAcSiteMergingInfo
- Atualiza um conjunto de informações de prefixo/sufixo de mesclagem de sites existente.Parâmetros:
Nome Descrição Obrigatório? Tipo SiteName
O nome usado para identificar o conjunto de prefixos/sufixos para um site específico. Ele pode corresponder ao nome do site real, mas não obrigatoriamente. x Cadeia de caracteres Parâmetros de fusão do site Consulte Parâmetros de fusão do site SwitchParameters Quiet
Suprimir o registro em log no console. SwitchParameter Retorna:
- Nenhuma
-
Remove-CvadAcSiteMergingInfo
- Remove um conjunto de informações de prefixo/sufixo de mesclagem de site existente.Parâmetros:
-
SiteName
– identifica o conjunto de prefixos e sufixos do site. Esta é uma cadeia de caracteres e é obrigatória.
Retorna:
- Nenhuma
-
Parâmetros de fusão do site
Os parâmetros a seguir podem ser usados ao executar os cmdlets de mesclagem de sites. Todos os parâmetros listados são cadeias de caracteres.
-
SiteName
- o nome usado para identificar o conjunto de prefixos/sufixos para um site específico. Ele pode corresponder ao nome do site real, mas não obrigatoriamente. SiteName é um parâmetro obrigatório. -
AdminScopedPrefix
- o prefixo que deve ser aplicado aos escopos do administrador. -
ApplicationPrefix
- o prefixo que deve ser aplicado aos aplicativos. -
ApplicationFolderPrefix
- o prefixo que deve ser aplicado às pastas de aplicativos;ApplicationFolderPrefix
pode ser combinado comApplicationFolderRoot
. -
ApplicationFolderRoot
- a nova pasta raiz para as pastas do aplicativo. Isso cria uma hierarquia de pastas extra.ApplicationFolderRoot
pode ser combinado comApplicationFolderPrefix
. -
ApplicationGroupPrefix
- o prefixo para grupos de aplicativos. -
ApplicationUserPrefix
- o prefixo que deve ser aplicado ao nome do aplicativo que o usuário vê. -
ApplicationAdminPrefix
- o prefixo que deve ser aplicado ao nome do aplicativo que o administrador vê. -
DeliveryGroupPrefix
- o prefixo que deve ser aplicado aos grupos de entrega. -
GroupPolicyPrefix
- o prefixo que deve ser aplicado aos nomes das políticas. -
HostConnectionPrefix
- o prefixo que deve ser aplicado às conexões de host. -
MachineCatalogPrefix
- o prefixo que deve ser aplicado aos catálogos de máquinas. -
StoreFrontPrefix
- o prefixo que deve ser aplicado aos nomes do StoreFront. -
TagPrefix
- o prefixo que deve ser aplicado às tags. -
AdminScopedSuffix
- o sufixo que deve ser aplicado aos escopos do administrador. -
ApplicationSuffix
- o sufixo que deve ser aplicado aos aplicativos. -
ApplicationFolderSuffix
- o sufixo que deve ser aplicado às pastas de aplicativos;ApplicationFolderSuffix
pode ser combinado comApplicationFolderRoot
. -
ApplicationGroupSuffix
- o sufixo para grupos de aplicativos. -
ApplicationUserSuffix
- o sufixo que deve ser aplicado ao nome do aplicativo que o usuário vê. -
ApplicationAdminSuffix
- o sufixo que deve ser aplicado ao nome do aplicativo que o administrador vê. -
DeliveryGroupSuffix
- o sufixo que deve ser aplicado aos grupos de entrega. -
GroupPolicySuffix
- o sufixo que deve ser aplicado aos nomes das políticas. -
HostConnectionSuffix
- o sufixo que deve ser aplicado às conexões do host. -
MachineCatalogSuffix
- o sufixo que deve ser aplicado aos catálogos de máquinas. -
StoreFrontSuffix
- o sufixo que deve ser aplicado aos nomes do StoreFront. -
TagSuffix
- o sufixo que deve ser aplicado às tags. -
SiteRootFolder
- o nome da pasta totalmente qualificado que deve ser usado para exportações e importações; pode ser uma pasta local ou um compartilhamento de arquivos.
Parâmetros genéricos
Parâmetros de acesso à nuvem
Todos os cmdlets que acessam a nuvem oferecem suporte aos seguintes parâmetros extras.
Nota:
O CustomerID, ClientID e Secret podem ser colocados no arquivo CustomerInfo.yml ou especificados com o cmdlet usando os seguintes parâmetros. Quando eles são especificados em ambos os lugares, os parâmetros do cmdlet têm precedência.
-
CustomerId
– O ID do cliente usado nas APIs Rest e é necessário para acessar todas as APIs Rest. Seu ID de cliente é encontrado no Citrix Cloud. -
ClientId
– O ClientID criado no site Citrix Cloud Identity and Access Management. Isso é necessário para obter o token de portador necessário para autenticação de todas as APIs Rest. -
Secret
– A chave secreta criada no site Citrix Cloud Identity and Access Management. Isso é necessário para obter o token de portador necessário para autenticação de todas as APIs Rest. -
CustomerInfoFileSpec
— A especificação do arquivo que aponta para um arquivo de informações do consumidor para substituir o local e o nome padrão.
Parâmetros do modo de migração
Os cmdlets que modificam a configuração do site na nuvem (Import
, Restore
, Merge
, New
e Sync
) oferecem suporte aos seguintes parâmetros extras para fornecer mais flexibilidade.
-
CheckMode
– Executa a operação de importação, mas não faz alterações. Todas as alterações esperadas são relatadas antes da conclusão da importação. Você pode usar esse comando para testar sua importação antes que ela ocorra. -
BackupFirst
– Faz backup do conteúdo da nuvem em arquivos .yml antes de modificar a configuração da nuvem. Essa opção está ativada por padrão. -
Confirm
– Quando true, solicita que os usuários confirmem que desejam fazer alterações na configuração do site na nuvem. O cmdletRemove
mostra um prompt devido à sua natureza destrutiva. Defina como false se não desejar nenhum prompt, como executar dentro de scripts automatizados. O padrão deConfirm
é true. -
SecurityFileFolder
– Esta é a pasta totalmente qualificada que contém o arquivo CustomerInfo.yml que pode apontar para uma pasta local ou uma pasta de compartilhamento de rede que pode estar sob controle de autenticação. A ferramenta não solicitará credenciais; o acesso ao recurso controlado deve ser obtido antes de executar a ferramenta. -
SiteName
– Especifica o prefixo de mesclagem do site e o sufixo definidos a serem usados ao importar. -
SiteActive
– Especifica se o site importado está ativo ou inativo. Por padrão, esse parâmetro é definido como$false
, o que significa que o site importado está inativo.
Parâmetros de exibição de log
Os cmdlets Export
, Import
, Sync
, Restore
, Backup
, Compare
e Remove
exibem o arquivo de log quando a operação é concluída. Você pode suprimir a exibição definindo o parâmetro -DisplayLog
como $false
. O Notepad.exe é usado como padrão para exibir o arquivo de log. Você pode especificar um editor diferente no arquivo CustomerInfo.yml.
Editor: C:\Program Files\Notepad++\notepad++.exe
Valores de retorno do cmdlet
ActionResult
Todos os cmdlets retornam o seguinte valor.
public class ActionResult
{
public bool Overall_Success;
public Dictionary<string, string> Individual_Success;
public object CustomResult;
}
Overall_Success
retorna um único booleano que mostra o sucesso geral do cmdlet em todos os componentes selecionados: verdadeiro, que significa bem-sucedido, e falso, que significa malsucedido.
Individual_Success
retorna um ou três valores para cada componente principal. O resultado de um componente pode ser Success, Failure ou Skipped. Skipped indica que o componente não foi selecionado para execução pelo cmdlet.
CustomResult
é específico do cmdlet.
CustomResult
Import
, Merge
, Restore
, Sync
, Compare
, Compare File
e Remove
retornam as seguintes informações de resultados personalizados para uma única instância do EvaluationResultData
.
Nota:
Os cmdlets
Export
eTemplate
não retornam um resultado personalizado.
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
exibe uma lista com uma entrada por componente selecionado. A chave é o nome do componente e o valor é uma lista de cada membro do componente e a ação executada nesse membro do componente. As ações podem ser qualquer um dos valores de ActionResultValues
.
Added
, Updated
, Deleted
, e NoChange
indicar que o número total de membros do componente adicionados, atualizados, excluídos ou nenhuma ação executada, nessa ordem.
TotalChanged
é a soma de Added
, Updated
e Deleted
.
OverallResult
é um único booleano que indica o resultado do cmdlet. O valor true indica sucesso total em todos os componentes e false indica falha no processamento de um ou mais componentes.
CloudBackupFolder
é a especificação de arquivo totalmente qualificada do backup de configuração do site na nuvem antes do cmdlet executar qualquer ação de modificação na nuvem.
SourceBackupFolder
é a especificação de arquivo totalmente qualificada do backup do arquivo de origem feito após a conclusão do cmdlet. Por padrão, esses arquivos estão em %HOMEPATH%\Documents\Citrix\AutoConfig.
Ajuda do PowerShell
A ajuda do PowerShell está disponível para cada cmdlet. Todos os parâmetros são documentados com cada cmdlet, juntamente com uma breve explicação sobre o cmdlet. Para acessar a ajuda de qualquer cmdlet, digite Get-Help
na frente do cmdlet.
Get-Help Import-CvadAcToSite