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: FileStorage ou CustomerAzureStorage . |
FileStoragefolder |
A especificação de pasta totalmente qualificada para a opção FileStorage de BlobStorageType . |
Info1
|
Para FileStorage , UserName opcional
Para CustomerAzureStorage , a URL SAS do Azure |
Info2 |
Para FileStorage , senha opcional |
Info3 e Info4
|
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 Quiet seja 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. True quando habilitado e false quando 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. True quando habilitado e false quando 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. |