Cmdlets da ferramenta de configuração automatizada para backup e restauração
Esta página lista todos os cmdlets e parâmetros compatíveis com a ferramenta para acionar as APIs de backup e restauração que o Studio usa.
Cmdlets de armazenamento de backup
Get-BckRstrStorage
Este cmdlet é aplicável apenas a ambientes locais. Obtém detalhes do armazenamento onde os backups são salvos.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
Set-BckRstrStorage
Este cmdlet é aplicável apenas a ambientes locais. Define um novo armazenamento onde os backups são salvos.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| MaximumBackups | O número máximo de backups não fixados a serem persistidos até que o processo de limpeza de backup remova os backups mais antigos quando novos backups forem criados. | 
| MaximumPinnedBackups | O número máximo de backups fixados a serem persistidos. Esses backups não são removidos pelo processo de limpeza. | 
| BlobStorageType | O tipo de armazenamento: FileStorageouCustomerAzureStorage. | 
| FileStoragefolder | A especificação de pasta totalmente qualificada para a opção FileStoragedeBlobStorageType. | 
| Info1 | Para FileStorage,UserNameopcionalPara CustomerAzureStorage, a URL SAS do Azure | 
| Info2 | Para FileStorage, senha opcional | 
| Info3eInfo4 | Não usados | 
Test-BckRstrStorage
Este cmdlet é aplicável apenas a ambientes locais. Testa para determinar se o armazenamento definido é válido.
Para FileStorage, o teste verifica se a pasta existe e pode ser gravada.
Para CustomerAzureStorage, o teste verifica se a URL SAS tem as permissões corretas e se a data atual está dentro das datas de início e término da URL.
Retorna true se for válido e false se for inválido.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
Cmdlets de backup
Get-BckRstrBackups
Enumera os backups armazenados no local de armazenamento de blob de Backup ou Restauração. Para Citrix Virtual Apps and Desktops™, este local é configurado pelo administrador através do WebStudio. Para DaaS, este é o armazenamento Azure do cliente pré-existente. Use Get-BckRstrBackupsWithDetiails para obter informações completas sobre cada backup. Os detalhes do backup incluem o seguinte:
- Nome do backup
- Notas
- Fixado (true ou false)
- Data e hora do backup
- UID do histórico
- UID relacionado (UID do último registro de histórico de Restauração)
- Data e hora relacionadas
- Relacionado se executado no modo de verificação
- Duração em segundos
- Nome do administrador
- Detalhes que enumeram cada componente e contagem de membros em cada componente.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
Get-BckRstrBackupsMembers
Enumera os membros de um único componente armazenados em um backup selecionado. Os nomes dos membros são retornados em uma lista simples.
Os componentes são:
- Tags
- AdminScopes
- AdminRoles
- AdminAdministrators (somente local)
- HostConnections
- Icons
- AdminFolders
- MachineCatalogs
- StoreFronts
- DeliveryGroups
- ApplicationGroups
- ApplicationFolders
- Applications
- AppVServers
- AppLibPackageDiscovery
- AppVIsolationGroups
- GroupPolicies
- UserZonePreferences
- SiteData
- Zones (somente local)
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| BackupName | O nome do backup. A extensão .zipé opcional. | 
| Component | Os componentes a serem incluídos no backup. | 
New-BckRstrBackup
Inicia uma nova ação de backup no Delivery Controller. Esta ação é assíncrona ao cmdlet New-BckRstrBackup.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| Notes | As notas sobre o backup. | 
| PollForCompletion | O parâmetro para sondar a ação em execução no Delivery Controller até que a ação seja concluída. O registro de sondagem registra o progresso e os resultados da conclusão no console, a menos que o parâmetro Quietseja especificado. | 
Cmdlets para fixar backups
Set-BckRstrPinBackups
Fixa um backup para que ele não seja removido como parte do processo de limpeza de backup do Delivery Controller.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| BackupName | O nome do backup. A extensão .zipé opcional. | 
Set-BckRstrUnpinBackups
Desafixa um backup para que ele esteja disponível para ser removido no processo de limpeza de backup do Delivery Controller.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| BackupName | O nome do backup. A extensão .zipé opcional. | 
Cmdlet para remover backup
Remove-BckRstrBackup
Remove um ou mais backups.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| IncludeByName | O filtro para especificar quais membros do componente considerar para restauração. Esta é uma lista de valores de filtro separados por vírgulas e pode conter os caracteres curinga *e?. | 
Cmdlets de backups agendados
Get-BckRstrSchedules
Obtém uma lista de agendamentos de backup.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| BackupName | O nome do backup. A extensão .zipé opcional. | 
| Notes | As notas a serem definidas ou alteradas. | 
New-BckRstrSchedule
Cria um novo agendamento de backup.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| Name | O nome do agendamento. | 
| Frequency | O tipo de frequência: Daily, Weekly ou Monthly. | 
| Day | Se a frequência for diária. | 
| DaysInWeek | Se a frequência for semanal. | 
| DayInMonth | Se a frequência for mensal. | 
| WeekInMonth | Se a frequência for mensal. | 
| StartDate | O formato é M/d/yy | 
| StartTime | A hora de início especificada como um relógio de 24 horas. | 
| FrequencyFactor | Executar a cada n vezes, como todos os dias (valor = 1) ou a cada dois dias (valor = 2) | 
| Description | A descrição do backup agendado | 
| Enabled | O parâmetro para habilitar este agendamento de backup. Truequando habilitado efalsequando desabilitado | 
| TimeZoneId | A ID do fuso horário do Windows | 
Set-BckRstrSchedule
Modifica um agendamento de backup existente. Forneça o nome ou Uid para selecionar o agendamento a ser modificado.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| Name | O nome do agendamento. | 
| Uid | Se o nome do agendamento for alterado. | 
| Frequency | O tipo de frequência: Daily, Weekly ou Monthly. | 
| Day | Se a frequência for diária. | 
| DaysInWeek | Se a frequência for semanal. | 
| DayInMonth | Se a frequência for mensal. | 
| WeekInMonth | Se a frequência for mensal. | 
| StartDate | O formato é M/d/yy | 
| StartTime | A hora de início especificada como um relógio de 24 horas. | 
| FrequencyFactor | Executar a cada n vezes, como todos os dias (valor = 1) ou a cada dois dias (valor = 2) | 
| Description | A descrição do backup agendado | 
| Enabled | O parâmetro para habilitar este agendamento de backup. Truequando habilitado efalsequando desabilitado | 
| TimeZoneId | A ID do fuso horário do Windows | 
Set-BckRstrScheduleEnabled
Habilita um agendamento de backup existente. Forneça o nome ou Uid para selecionar o agendamento a ser habilitado.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| Name | O nome do agendamento. | 
| Uid | Se o nome do agendamento for alterado. | 
Set-BckRstrScheduleDisabled
Desabilita um agendamento de backup existente. Forneça o nome ou Uid para selecionar o agendamento a ser desabilitado.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| Name | O nome do agendamento. | 
| Uid | Se o nome do agendamento for alterado. | 
Cmdlet para limitar backups
Set-BckRstrOptions
Limita os backups agendados a um por dia para evitar backups idênticos.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| OneScheduledBackupPerDay | O parâmetro para limitar os backups agendados a um por dia para evitar backups idênticos. | 
Cmdlet de restauração
Restore-BckRstrBackups
Restaura membros de um único componente de um backup existente.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| BackupName | O nome do backup. A extensão .zipé opcional. | 
| Component | Os componentes a serem incluídos no backup. | 
| Notes | As notas sobre o backup. | 
| CheckMode | O parâmetro para identificar membros do componente que seriam restaurados, mas não executa a restauração real. | 
| RestoreType | O tipo de restauração: MissingOnly ou MissingUpdateExisting | 
| IncludeByName | O filtro para especificar quais membros do componente considerar para restauração. Esta é uma lista de valores de filtro separados por vírgulas e pode conter os caracteres curinga *e?. | 
Cmdlets de histórico
Get-BckRstrHistory
Obtém uma lista de detalhes do histórico para todas as ações.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
Get-BckRstrSpecificBackupHistory
Obtém uma lista de detalhes do histórico para um backup específico.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| BackupName | O nome do backup. A extensão .zipé opcional. | 
Set-BckRstrNotes
Define ou altera as notas em um registro de histórico.
Parâmetros:
| Parâmetro | Descrição | 
|---|---|
| CustomerId | A ID do cliente necessária para obter um token de portador. | 
| CientId | A ID do cliente necessária para obter um token de portador. | 
| Secret | O segredo necessário para obter um token de portador. | 
| CustomerInforFileSpec | A especificação de arquivo totalmente qualificada do arquivo de informações do cliente contendo informações de segurança e ambiente. | 
| ProfileName | O parâmetro para identificar um perfil de segurança existente usado no lugar dos parâmetros anteriores. Consulte XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud para saber como definir perfis de segurança. | 
| Environment | O tipo de ambiente de produção: Production, ProductionGov, ProductionJP, OnPrem. | 
| Quiet | O parâmetro para suprimir a saída para o console. | 
| BackupName | O nome do backup. A extensão .zipé opcional. | 
| Notes | As notas a serem definidas ou alteradas. |