Citrix DaaS

Gerenciar catálogos de máquinas de imagem preparados

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:

  • Estúdio
  • 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 Catálogos de máquinas no painel de navegação 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. No Imagem , selecione uma imagem preparada.

    Observação:

    Aplicável ao Azure: você também pode escolher uma imagem com ACG não habilitado e depois selecionar Colocar a imagem preparada na Galeria de Computação do Azure para colocar as imagens na galeria.

  3. No Estratégia de distribuição , selecione quando deseja atualizar este catálogo com a imagem preparada selecionada.
  4. No Resumo , verifique os detalhes. Clique Acabar.

Você pode ver o histórico de alterações de imagem feitas em um catálogo. Para ver o histórico, faça o seguinte:

  1. Selecione um catálogo de máquinas.
  2. Sob o Propriedades do modelo na guia Imagem preparada , clique em Ver histórico de imagens.

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 Imagens , selecione uma definição de imagem e selecione Editar definição de imagem.

Editar versão da imagem

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

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

  1. Vá para o Imagens , selecione uma versão da imagem e selecione Editar descrição.

Excluir uma versão da imagem

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

  1. Vá para o Imagens , selecione uma versão da imagem e selecione Excluir versão da imagem.

Observação:

Você não pode excluir uma versão de imagem se ela for 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 Imagens , selecione uma definição de imagem e selecione Excluir definição de imagem.

Observação:

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 Set-ProvSchemeImage comando. Por exemplo,

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

Ou,

  Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--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
<!--NeedCopy-->

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

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

  • Uma definição de imagem não poderá ser excluída se contiver qualquer versão de imagem.
  • Uma versão de imagem não poderá ser excluída se contiver qualquer especificação de versão de imagem.
  • Uma especificação de versão de imagem mestre não poderá 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 poderá ser excluída se for usada por qualquer catálogo de máquinas do 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 da máquina. Por exemplo,

      Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
    <!--NeedCopy-->
    
  2. Remova a especificação da versão da 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 da versão da imagem mestre. Por exemplo,

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

    Observação:

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

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

      Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
    <!--NeedCopy-->
    
  6. Remova a configuração para 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 a unidade 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 a unidade 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 a definição e a versão da 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 Renomear-ProvImageDefinition comando. 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 Set-ProvImageDefinition comando. Por exemplo:

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

    Ou,

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

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

    Ou,

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

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

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

       Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
     <!--NeedCopy-->
    
  • Obtenha detalhes da versão da imagem usando o Get-ProvImageVersion comando. 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 da imagem,

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

      Ou,

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

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

         Get-ProvImageVersionSpec -ImageVersionUid <Guid>
       <!--NeedCopy-->
      
    • Para listar as especificações de versão da 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 preparadas 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 preparadas com êxito 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 de especificação de versão de imagem preparada,

         Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
       <!--NeedCopy-->
      
  • Obtenha detalhes do esquema de provisionamento usando o Get-ProvScheme comando. 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 de especificações de versão da imagem preparada de um esquema de provisionamento usando o Get-ProvSchemeImageVersionSpecHistory comando. 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 preparados