Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Gerenciar catálogos de máquinas de imagem preparada

January 23, 2026
Contribuição de: 
C

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:

Usar o Web 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 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. Na página “Imagem”, selecione uma imagem preparada.

    Observação:

    Aplicável ao Azure: Você também pode escolher uma imagem com ACG desabilitado 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. Na página “Estratégia de implantação”, selecione quando você deseja atualizar este catálogo com a imagem preparada selecionada.
  4. Na página “Resumo”, verifique os detalhes. Clique em “Concluir”.

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. 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 da Imagem”.

Observação:

Não é possível 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 nó “Imagens”, selecione uma definição de imagem e selecione “Excluir Definição de Imagem”.

Observação:

Não é possível 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]
<!--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 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 ela contiver qualquer versão de imagem.
  • Uma versão de imagem não pode ser excluída se ela 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 ela 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 ela for usada por qualquer catálogo de máquinas MCS.
  • Uma unidade de hospedagem não pode ser excluída se ela 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-->

    Observação:

    A especificação de versão de 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 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 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 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
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.