Citrix DaaS™

Gerenciar catálogos de máquinas de imagem preparada

Você pode atualizar um catálogo de máquinas MCS existente com uma imagem preparada diferente e gerenciar as definições e versões de imagem usando:

  • Studio
  • PowerShell

Usar o Studio

Atualizar um catálogo de máquinas com uma imagem preparada diferente

Para atualizar um catálogo de máquinas MCS existente com uma imagem preparada diferente, faça o seguinte:

  1. Clique em “Catálogos de Máquinas” no painel esquerdo e selecione um catálogo de máquinas que você deseja atualizar. Clique com o botão direito do mouse e selecione “Alterar Imagem Preparada”.
  2. Na página “Imagem”, selecione uma imagem preparada. Se necessário, adicione uma nota para a imagem preparada selecionada.

    Nota:

    (Somente Azure) Você também pode escolher uma imagem com ACG não habilitado e, posteriormente, selecionar a caixa de seleção “Colocar imagem preparada na Galeria de Computação do Azure” para colocar as imagens na galeria.

  3. Para reverter para uma imagem preparada atribuída anteriormente, clique em “Usar atribuição de imagem anterior para reversão rápida” na parte inferior do assistente.

    Uma nova janela é aberta e exibe uma lista de todas as atribuições de imagem históricas disponíveis. Ao selecionar uma imagem da lista, a versão correspondente é selecionada automaticamente na árvore de imagens preparadas na página de imagem.

  4. Na página “Estratégia de implantação”, selecione quando você deseja atualizar este catálogo com a imagem preparada selecionada.
  5. Na página “Resumo”, verifique os detalhes. Clique em “Concluir”.

Para visualizar o histórico de alterações de imagem feitas em um catálogo, siga estas etapas:

  1. Selecione um catálogo de máquinas.
  2. Na guia “Propriedades do Modelo”, no campo “Imagem preparada”, clique em “Exibir histórico da imagem”.

Gerenciar as definições e versões de imagem

Você pode editar e excluir as definições e versões de imagem para gerenciar o uso de várias versões e definições de imagem criadas.

Editar uma definição de imagem

Você pode editar o nome e a descrição de uma definição de imagem.

Para editar uma definição de imagem, faça o seguinte:

  1. Vá para o nó “Imagens”, selecione uma definição de imagem e selecione “Editar Definição de Imagem”.

Editar versão de imagem

Você pode editar a descrição de uma versão de imagem para especificar a finalidade dessa versão de imagem.

Para editar uma versão de imagem, faça o seguinte:

  1. Vá para o nó “Imagens”, selecione uma versão de imagem e selecione “Editar Descrição”.

Excluir uma versão de imagem

Para excluir uma versão de imagem, faça o seguinte:

  1. Vá para o nó “Imagens”, selecione uma versão de imagem e selecione “Excluir Versão de Imagem”.

Nota:

Você não pode excluir uma versão de imagem se ela estiver sendo usada por um catálogo de máquinas.

Excluir uma definição de imagem

Para excluir uma definição de imagem, faça o seguinte:

  1. Vá para o nó “Imagens”, selecione uma definição de imagem e selecione “Excluir Definição de Imagem”.

Nota:

Você não pode excluir uma definição de imagem se ela contiver uma versão de imagem.

Usar o PowerShell

Atualizar um catálogo usando uma especificação de versão de imagem preparada

Você pode atualizar um catálogo usando o comando Set-ProvSchemeImage. Por exemplo,

Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
[-ImageAssignmentNote <string>]
<!--NeedCopy-->

Ou,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
[-ImageAssignmentNote <string>]
<!--NeedCopy-->

Exemplo do conjunto completo de comandos do PowerShell para atualizar um catálogo:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"

Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously -ImageAssignmentNote "Update from VST team"
<!--NeedCopy-->

Obter o histórico de alterações de imagem para o esquema de provisionamento

Get-ProvSchemeImageVersionSpecHistory -ProvisioningSchemeName azurecatalog
<!--NeedCopy-->

Excluir definição de imagem, versão de imagem e especificação de versão de imagem preparada

Considere o seguinte antes de excluir uma definição de imagem, versão de imagem e especificação de versão de imagem preparada:

  • Uma definição de imagem não pode ser excluída se contiver qualquer versão de imagem.
  • Uma versão de imagem não pode ser excluída se contiver qualquer especificação de versão de imagem.
  • Uma especificação de versão de imagem mestre não pode ser excluída se for usada por qualquer outra especificação de versão de imagem preparada.
  • Uma especificação de versão de imagem preparada não pode ser excluída se for usada por qualquer catálogo de máquinas MCS.
  • Uma unidade de hospedagem não pode ser excluída se for usada por qualquer outra especificação de versão de imagem preparada.

As etapas detalhadas são as seguintes:

  1. Remova o catálogo de máquinas. Por exemplo,

    Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
    <!--NeedCopy-->
    
  2. Remova a especificação de versão de imagem preparada compartilhada. Por exemplo,

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
    <!--NeedCopy-->
    
  3. Remova uma especificação de versão de imagem preparada. Por exemplo,

    $PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
    
    Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
    <!--NeedCopy-->
    
  4. Remova a especificação de versão de imagem mestre. Por exemplo,

    $MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
    
    Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronousl
    <!--NeedCopy-->
    

    Nota:

    A especificação de versão de imagem mestre só pode ser excluída quando não há nenhuma especificação de versão de imagem preparada associada.

  5. Remova uma versão de imagem. Por exemplo,

    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
    <!--NeedCopy-->
    
  6. Remova a configuração para a definição de imagem na conexão de hospedagem especificada. Por exemplo,

    Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx
    <!--NeedCopy-->
    
  7. Remova uma definição de imagem. Por exemplo,

    Remove-ProvImageDefinition -ImageDefinitionName image1
    <!--NeedCopy-->
    

Exemplo do conjunto completo de comandos do PowerShell quando a imagem preparada não é compartilhada entre unidades de host:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Exemplo do conjunto completo de comandos do PowerShell quando a imagem preparada é compartilhada entre unidades de host:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> 
-HostingUnitName AzureWest

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

Remove-ProvImageDefinition -ImageDefinitionName image1
<!--NeedCopy-->

Gerenciar definição de imagem e versão de imagem

Você pode renomear e editar uma definição de imagem, e editar uma versão de imagem.

  • Renomeie uma definição de imagem usando o comando Rename-ProvImageDefinition. Por exemplo:

     Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
     <!--NeedCopy-->
    

    Ou,

     Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
     <!--NeedCopy-->
    
  • Edite uma definição de imagem usando o comando Set-ProvImageDefinition. Por exemplo:

     Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
     <!--NeedCopy-->
    

    Ou,

     Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
     <!--NeedCopy-->
    
  • Edite uma versão de imagem usando o comando Set-ProvImageVersion. Por exemplo:

     Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
     <!--NeedCopy-->
    

    Ou,

     Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
     <!--NeedCopy-->
    

Obter detalhes da definição de imagem, versão de imagem, especificação de versão de imagem preparada e esquema de provisionamento

  • Obtenha detalhes da definição de imagem usando o comando Get-ProvImageDefinition. Por exemplo:

     Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
     <!--NeedCopy-->
    
  • Obtenha detalhes da versão de imagem usando o comando Get-ProvImageVersion. Por exemplo:

    • Para listar versões de imagem em uma definição de imagem,

       Get-ProvImageVersion -ImageDefinitionUid <Guid>
       <!--NeedCopy-->
      

      Ou,

       Get-ProvImageVersion -ImageDefinitionName <string>
       <!--NeedCopy-->
      
    • Para obter um detalhe da versão de imagem,

       Get-ProvImageVersion -ImageVersionUid <Guid>
       <!--NeedCopy-->
      

      Ou,

       Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
       <!--NeedCopy-->
      
  • Obtenha a especificação de versão de imagem preparada usando o comando Get-ProvImageVersionSpec. Por exemplo:

    • Para listar todas as especificações de versão de imagem preparada em uma versão de imagem,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid>
       <!--NeedCopy-->
      
    • Para listar as especificações de versão de imagem mestre em uma especificação de versão de imagem preparada,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
       <!--NeedCopy-->
      
    • Para listar as especificações de versão de imagem preparada em uma versão de imagem, que está associada a uma imagem mestre,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
       <!--NeedCopy-->
      
    • Para obter especificações de versão de imagem preparada bem-sucedidas em uma versão de imagem,

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
       <!--NeedCopy-->
      
    • Para obter um detalhe da especificação de versão de imagem preparada,

       Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
       <!--NeedCopy-->
      
  • Obtenha detalhes do esquema de provisionamento usando o comando Get-ProvScheme. Por exemplo:

     Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
     <!--NeedCopy-->
    
  • Obtenha o histórico da especificação de versão de imagem preparada de um esquema de provisionamento usando o comando Get-ProvSchemeImageVersionSpecHistory. Por exemplo:

     Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
     <!--NeedCopy-->
    

Mais informações

Gerenciar catálogos de máquinas de imagem preparada