Gerenciamento de imagens

Last published : Nov 13, 2026
Related information
Instalar e configurar

Introdução

O processo de criação ou atualização do catálogo MCS tem duas fases:
  • Masterização: uma imagem de origem é convertida em uma imagem publicada
  • Clonagem: novas VMs são criadas a partir da imagem publicada
Com a funcionalidade de gerenciamento de imagens, o MCS separa a fase de masterização do fluxo de trabalho geral de provisionamento.
Você pode preparar várias versões de imagem MCS (Imagem Preparada) a partir de uma única imagem de origem e usá-la em vários catálogos de máquinas MCS diferentes. Essa implementação reduz significativamente os custos de armazenamento e tempo, e simplifica o processo de implantação de VM e atualização de imagem.
Os benefícios de usar essa funcionalidade de gerenciamento de imagens são:
  • Gerar imagens preparadas com antecedência sem criar um catálogo.
  • Reutilizar imagens preparadas em vários cenários, como criar e atualizar um catálogo.
  • Reduzir significativamente o tempo de criação ou atualização do catálogo.
Observação:
  • Este recurso é atualmente aplicável a ambientes de virtualização Azure e VMware.
  • Você pode criar um catálogo de máquinas MCS sem usar imagens preparadas. Nesse caso, você não poderá obter os benefícios do recurso.
  • O recurso está geralmente disponível a partir do Citrix Virtual Apps and Desktops™ 2402 LTSR CU2.

Casos de uso

Alguns dos casos de uso da funcionalidade de gerenciamento de imagens são:
  • Gerenciamento de versões: As versões de imagem permitem que você:
    • gerenciar diferentes iterações ou atualizações de uma imagem específica.
    • manter várias versões de uma imagem para diferentes propósitos.
  • Agrupamento lógico: Você pode criar várias definições de imagem para:
    • agrupar logicamente versões de imagem com base em vários critérios, como projeto, departamento ou tipo de aplicativo e desktop.
    • gerenciar imagens de forma mais eficiente dentro de uma organização.

O que é uma imagem preparada?

Com a funcionalidade de gerenciamento de imagens, o MCS desvincula a fase de masterização do fluxo de trabalho geral de criação ou atualização de catálogo e divide o processo em duas etapas:
  1. Criar imagens preparadas a partir de uma única imagem de origem.
  2. Usar a imagem preparada para criar ou atualizar um catálogo de máquinas MCS.
Você pode criar as imagens preparadas com antecedência. Você pode usar uma única imagem preparada para criar ou atualizar vários catálogos de máquinas provisionados pelo MCS.
Entenda como uma imagem preparada é usada em vários catálogos de máquinas MCS ao usar o Web Studio a partir da imagem:
Visão geral da imagem preparada
Definição de imagem: As definições de imagem são um agrupamento lógico de versões de uma imagem. A definição de imagem contém informações sobre:
  • por que a imagem foi criada
  • para qual SO ela se destina
  • outras informações sobre o uso da imagem.
Um catálogo não é criado a partir de uma definição de imagem, mas a partir das versões de imagem que são criadas com base na definição de imagem.
Versão da imagem: As versões da imagem gerenciam o versionamento para a definição da imagem. Uma definição de imagem pode ter várias versões de imagem. Use as versões da imagem como imagens preparadas para criar ou atualizar um catálogo.
Alternativamente, se você quiser usar comandos PowerShell para criar um esquema de provisionamento para criar ou atualizar um catálogo, então você deve criar uma especificação de versão de imagem preparada com base na especificação de versão de imagem mestre, conforme necessário para o seu ambiente.

Requisito

  • Para imagens mestre do Windows, apenas imagens VDA versão 2311 ou posterior são suportadas. O componente MCS/IO deve ser explicitamente selecionado e instalado. A ativação ou desativação da configuração de E/S do MCS deve ser determinada durante a criação ou atualização do catálogo de máquinas, pois não está ativada por padrão.

Limitações

Atualmente, o recurso não oferece suporte ao seguinte:
  • Múltiplas NICs no Azure
  • Recurso de disco de dados persistente
  • Hibernação para multi-sessão
  • Alteração do tipo de imagem

Gerenciamento do ciclo de vida da imagem usando o Web Studio

O ciclo de vida da imagem ao usar o Web Studio é:
  1. Criar uma imagem preparada: Crie uma definição de imagem e sua versão inicial.
  2. Crie versões de imagem a partir da versão inicial da imagem.
  3. Use uma versão de imagem como imagem preparada para criar catálogos.
  4. Atualize um catálogo de máquinas com uma imagem preparada diferente.
  5. Gerenciar as definições e versões de imagem: Editar o nome e a descrição das versões de imagem e a descrição de uma definição de imagem.
  6. Excluir uma versão de imagem.
  7. Excluir uma definição de imagem.
Alternativamente, você também pode gerenciar imagens usando o PowerShell. Consulte Gerenciamento do ciclo de vida da imagem usando o PowerShell.

Criar ou atualizar um catálogo usando uma imagem preparada

Crie imagens preparadas e use as imagens preparadas para criar ou atualizar um catálogo de máquinas MCS usando:

Usar o Web Studio

Consulte os seguintes tópicos:

Compreender o nó Imagens

Use o nó Imagens para criar e gerenciar imagens preparadas por MCS. Sua visualização principal é dividida em quatro partes:
visualização-principal-do-nó-imagens
Rótulo Parte Descrição
A Definições de imagem Lista as definições de imagem criadas anteriormente.
B Versões de imagem Exibe as versões de imagem da definição de imagem selecionada.
C Detalhes
  • A guia Detalhes exibe informações detalhadas sobre a definição ou versão de imagem selecionada, como Imagem Mestra, Recurso, Hypervisor, nome da definição de imagem, tipo de SO e tipo de sessão.
  • A guia Esquema de Imagem exibe informações sobre o modelo usado para preparar imagens, como disco rígido, tamanho da máquina, tipo de licença, conjunto de criptografia de disco, perfil da máquina e assim por diante.
  • A guia Esquemas de Provisionamento exibe o nome do esquema de provisionamento usado para criar o catálogo.
  • A guia Solução de Problemas fornece o status de erro da versão de imagem selecionada.
D Barra de ações Lista as ações que você pode realizar em definições e versões de imagem, como Criar Versão da Imagem, Editar Descrição, Excluir Versão da Imagem e Criar Catálogo.

Criar um catálogo de máquinas usando a imagem preparada

As principais etapas para criar um catálogo de máquinas MCS usando a imagem preparada são:
  1. Crie a definição da imagem e as versões iniciais da imagem.
  2. Use a versão da imagem como uma imagem preparada para criar um catálogo.

Criar uma definição de imagem e a versão inicial da imagem

Para criar uma definição de imagem e a versão inicial da imagem, faça o seguinte:
  1. Faça login no Web Studio e selecione o nó Imagens. Clique em Avançar na página Introdução.
  2. Na página Definição de Imagem, especifique o Tipo de SO e o Tipo de Sessão para a definição da imagem.
  3. Na página Imagem, selecione Recursos e uma imagem mestre para usar como modelo para criar a versão da imagem. Você pode marcar a caixa de seleção Usar um perfil de máquina e selecionar um perfil de máquina.
    Observação:
    Antes de selecionar uma imagem, verifique se a imagem mestre tem o VDA 2311 ou posterior instalado e se o driver MCSIO está instalado no VDA.
  4. (Somente para Azure) Na página Tipos de Armazenamento e Licenças, selecione o tipo de armazenamento e licença a ser usado como parte do processo de preparação da imagem.
    Observação:
    Se você selecionar um perfil de máquina na página Imagem, o tipo de licença do perfil de máquina será pré-selecionado com base na configuração do perfil.
  5. Na página Especificação da Máquina:
    • Para Azure, selecione um tamanho de máquina. Se você selecionar um perfil de máquina na página Imagem, o tamanho da máquina do perfil de máquina será selecionado por padrão.
    • Para VMware, se você selecionar um perfil de máquina, poderá ver a contagem de CPUs Virtuais derivada do perfil de máquina e ela será inalterável. Se você não selecionar um perfil de máquina, poderá ver apenas o tamanho da memória derivado da imagem mestre.
  6. Na página NICs, selecione ou adicione NICs para a imagem de preparação. Para cada NIC, selecione uma rede virtual associada.
    Para VMware, se você não selecionar um perfil de máquina, a NIC associada à imagem mestre será selecionada por padrão. Se você selecionar um perfil de máquina, as NICs serão derivadas do perfil de máquina e a contagem será inalterável.
    Observação:
    Múltiplas NICs não são suportadas no Azure.
  7. (Somente para Azure) Na página Configurações de Disco, selecione a chave de criptografia gerenciada pelo cliente (CMEK). Se o perfil da máquina não tiver uma CMEK, mas a imagem mestre tiver, ele pré-selecionará a CMEK da imagem mestre.
  8. Na página Descrição da Versão, insira uma descrição para a versão inicial da imagem criada.
  9. Na página Resumo, verifique os detalhes da definição da imagem e da versão inicial da imagem criada. Insira um nome e uma descrição para a definição da imagem. Clique em Concluir.

Criar versões de imagem

As versões de imagem permitem o gerenciamento de diferentes iterações ou atualizações para uma imagem específica. Essa funcionalidade permite que você mantenha várias versões de uma imagem para diferentes finalidades.
Para criar versões de imagem a partir da versão inicial da imagem, faça o seguinte:
Observação:
A unidade de hospedagem de todas as versões da imagem deve ser a mesma.
  1. Vá para o nó Imagens, selecione uma versão da imagem e selecione Criar Versão da Imagem.
  2. Se você quiser que a configuração da versão da imagem seja diferente da versão da imagem configurada inicialmente, configure as definições nas páginas Imagem, Tipos de Armazenamento e Licença, Especificação da Máquina, NICs e Configurações de Disco da caixa de diálogo Criar Versão da Imagem.
  3. Adicione uma descrição para a versão da imagem. Clique em Concluir.
create-image-versions

Criar um catálogo de máquinas a partir do nó Imagens

Use a opção Criar catálogo no nó Imagens para criar um catálogo usando a versão da imagem.
Alternativamente, você pode selecionar a versão ao criar um catálogo no nó Catálogos de Máquinas, vinculando à opção de imagem preparada no fluxo de trabalho de criação de catálogo. Consulte Criar um catálogo de máquinas a partir do nó Catálogos de Máquinas
Para criar um catálogo de máquinas MCS a partir do nó Imagens, faça o seguinte:
  1. Selecione uma versão da imagem e clique em Criar catálogo. Clique em Avançar na página Introdução.
  2. Na página Experiência da Área de Trabalho, selecione a experiência da área de trabalho necessária.
  3. Da página Imagem à página Configurações de Disco, as configurações são pré-selecionadas com base na versão da imagem selecionada.
  4. (Para Azure) Na página Grupo de Recursos, você pode optar por criar um novo grupo de recursos ou usar um grupo de recursos existente para colocar os recursos deste catálogo.
  5. Conclua as configurações nas páginas seguintes.
  6. Na página Resumo, verifique os detalhes do catálogo de máquinas. Insira um nome e uma descrição para o catálogo de máquinas. Clique em Concluir.
  7. Vá para o nó Catálogos de Máquinas para ver o catálogo de máquinas criado.

Criar um catálogo de máquinas a partir do nó Catálogos de Máquinas

Para criar um catálogo de máquinas MCS a partir do nó Catálogos de Máquinas, faça o seguinte:
  1. Clique em Catálogos de Máquinas no painel de navegação esquerdo.
  2. Clique em Criar Catálogo de Máquinas. A página Configuração do Catálogo de Máquinas é exibida. Clique em Avançar nas páginas Introdução, Tipo de Máquina e Gerenciamento de Máquinas.
  3. Na página Imagem:
    1. Selecione Imagem preparada.
    2. Em Imagem preparada, selecione uma versão de imagem de uma definição de imagem.
    3. Clique no nome da versão da imagem. Para ver mais detalhes sobre a versão da imagem selecionada, clique no número da versão, que está sublinhado.
    4. Se a versão da imagem selecionada estiver configurada com um perfil de máquina, selecione um perfil de máquina. Se a versão da imagem selecionada não estiver configurada com um perfil de máquina, você não poderá optar por usar um perfil de máquina.
  4. Configure as configurações nas páginas a seguir.
  5. Na página Configurações de Disco, se a imagem preparada selecionada usar um conjunto de criptografia de disco, você não poderá remover o conjunto de criptografia, mas poderá alterar a chave para outra chave de criptografia.
  6. (Para Azure) Na página Grupo de Recursos, você pode optar por criar um novo grupo de recursos ou usar um grupo de recursos existente para colocar os recursos deste catálogo.
  7. Conclua as configurações nas páginas seguintes.
  8. Na página Resumo, verifique os detalhes do catálogo de máquinas. Insira um nome e uma descrição para o catálogo de máquinas. Clique em Concluir.

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 e selecione Alterar Imagem Preparada.
  2. Na página Imagem, selecione uma imagem preparada.
  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 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 da 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 da imagem

Para excluir uma versão da imagem, faça o seguinte:
  1. Vá para o nó Imagens, selecione uma versão de imagem e selecione Excluir Versão da Imagem.
Nota:
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 nó Imagens, selecione uma definição de imagem e selecione Excluir Definição de Imagem.
Nota:
Não é possível excluir uma definição de imagem se ela contiver uma versão de imagem.

Gerenciamento do ciclo de vida da imagem usando PowerShell

Se você quiser usar comandos do PowerShell para criar um esquema de provisionamento, deverá criar uma especificação de versão de imagem preparada com base na especificação de versão de imagem mestre, conforme necessário para seu ambiente.
Especificação de versão da imagem mestre: Uma especificação de versão da imagem mestre é uma imagem específica adicionada ou criada em uma versão de imagem. Você pode adicionar uma imagem existente no hipervisor como uma especificação de versão da imagem mestre ou criar uma especificação de versão da imagem preparada com base na especificação da imagem mestre, conforme necessário para seu ambiente. A especificação de versão da imagem preparada pode ser usada para vários esquemas de provisionamento.
O ciclo de vida de uma imagem ao usar comandos do PowerShell é:
  1. Criar uma imagem:
    1. Criar uma definição de imagem.
    2. Criar uma versão de imagem.
    3. Adicionar uma especificação de versão de imagem mestre.
    4. Criar uma especificação de versão de imagem preparada.
  2. Criar um catálogo de máquinas MCS usando uma especificação de versão de imagem preparada:
    1. Criar um catálogo de broker.
    2. Crie um pool de identidades.
    3. Criar um esquema de provisionamento com o parâmetro Uid da especificação de versão de imagem preparada usando o comando New-ProvScheme.
    4. Vincular o catálogo de broker ao esquema de provisionamento.
  3. Criar VMs no catálogo de máquinas MCS.
  4. Alterar a especificação de versão de imagem preparada de um esquema de provisionamento usando o comando Set-ProvScheme.
  5. Gerenciar as definições e versões de imagem: Editar as versões de imagem e as definições de imagem.
  6. Excluir um catálogo de máquinas MCS: A ordem de exclusão é: especificação de versão de imagem preparada > especificação de versão de imagem mestre > versão de imagem > definição de imagem. Antes de excluir a especificação de versão de imagem, certifique-se de que a especificação de versão de imagem preparada não esteja associada a nenhum catálogo de máquinas MCS.

Usar o PowerShell

Você pode fazer o seguinte usando comandos PowerShell:
  • Criar uma imagem preparada
  • Criar um catálogo usando a especificação de versão de imagem preparada
  • Atualizar um catálogo usando uma especificação de versão de imagem preparada(#update-a-catalog-using-a-prepared-image-version-spec)
  • Excluir definição de imagem, versão de imagem e especificação de versão de imagem preparada(#delete-image-definition-image-version-and-prepared-image-version-spec)
  • Gerenciar definição de imagem e versão de imagem(#manage-image-definition-and-image-version)
  • Obter definição de imagem, versão de imagem, especificação de versão de imagem preparada e detalhes do esquema de provisionamento(#get-image-definition-image-version-prepared-image-version-spec-and-provisioning-scheme-details)

Criar uma imagem preparada

Os comandos detalhados do PowerShell para criar uma especificação da versão da imagem preparada são os seguintes:
  1. Verifique os nomes de definição de imagem disponíveis usando Test-ProvImageDefinitionNameAvailable command. Por exemplo,
    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
  2. Crie uma definição de imagem usando o comando New-ProvImageDefinition. Por exemplo,
    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
  3. Crie uma versão de imagem usando o comando New-ProvImageVersion. Por exemplo,
    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
  4. Adicione uma especificação de versão de imagem mestre à versão da imagem usando o comando Add-ProvImageVersionSpec. Por exemplo,
    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName azure -MasterImagePath "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
    Nota:
    Você pode adicionar apenas uma especificação de versão de imagem mestre a uma versão de imagem para uma unidade de hospedagem.
  5. Crie uma especificação de versão de imagem preparada a partir da especificação de versão de imagem mestre usando o comando New-ProvImageVersionSpec. Por exemplo,
    New-ProvImageVersionSpec
    -SourceImageVersionSpecUid  c6e7384c-b2f8-46d6-9519-29a2c57ed3cb
    -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"
    -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
    Nota:
    Uma unidade de hospedagem e tipo de preparação podem ter apenas uma instância preparada.
Exemplo do conjunto completo de comandos Powershell para criar definição de imagem, versão de imagem e especificação de versão de imagem preparada no Azure:
$ImageDefintion = New-ProvImageDefinition
-ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 $ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\azure\image.folder\azureresourcegroup.resourcegroup\win2022-snapshot.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName azure -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2ms.serviceoffering" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
Exemplo do conjunto completo de comandos Powershell para criar definição de imagem, versão de imagem e especificação de versão de imagem preparada no VMware:
$ImageDefintion = New-ProvImageDefinition -ImageDefinitionName image2 -OsType Windows -VdaSessionSupport SingleSession
$ImageVersion = New-ProvImageVersion -ImageDefinitionName $ImageDefintion.ImageDefinitionName -Description "version 1"
$MasterImagePath = "XDHyp:\HostingUnits\vmware\win10-master.vm\win10-master-snap.snapshot"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageDefinitionName $ImageVersion.ImageDefinitionName -ImageVersionNumber $ImageVersion.ImageVersionNumber -HostingUnitName vmware -MasterImagePath $MasterImagePath
$Task = New-ProvImageVersionSpec -SourceImageVersionSpecUid  $SourceImageVersionSpec.ImageVersionSpecUid -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
Nota:
  • Todas as especificações de versão de imagem em uma definição de imagem devem pertencer à mesma unidade de hospedagem.
  • Uma versão de imagem pode ter apenas uma especificação de versão de imagem mestre e uma especificação de versão de imagem preparada.
  • Todas as especificações de versão de imagem devem ter um perfil de máquina ou nenhuma das especificações de versão de imagem deve ter um perfil de máquina.
  • Não é possível especificar um grupo de recursos ao criar uma especificação de versão de imagem.

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

Crie um catálogo de máquinas MCS a partir da especificação de versão de imagem preparada usando o comando New-ProvScheme. Por exemplo,
New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
Ou,
New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitName <string> -IdentityPoolName <string> [-VMCpuCount <int>] [-VMMemoryMB <int>] [-UseWriteBackCache] [-NetworkMapping <Hashtable>] [-CleanOnBoot] [-Scope <string[]>] [-Metadata <Hashtable>] [-ServiceOffering <string>] [-SecurityGroup <string[]>] [-TenancyType <string>] [-MachineProfile <string>] [-CustomProperties <string>] [-ResetAdministratorPasswords] [-UseFullDiskCloneProvisioning] [-RunAsynchronously] [-PurgeJobOnSuccess] [-ProvisioningSchemeType <ProvisioningSchemeType>]
Exemplo do conjunto completo de comandos Powershell para criar um catálogo no Azure:
$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "azurecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "azure.local" -IdentityPoolName "azurecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "azure##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName azure -IdentityPoolName azurecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -ServiceOffering "XDHyp:\HostingUnits\azure\serviceoffering.folder\Standard_B2s.serviceoffering" -NetworkMapping @{"0"="XDHyp:\HostingUnits\azure\virtualprivatecloud.folder\azureresourcegroup.resourcegroup\azure-vnet-eastus.virtualprivatecloud\dev.network"} -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"StorageAccountType`" Value=`"StandardSSD_LRS`" /></CustomProperties>" -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName azurecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
Exemplo do conjunto completo de comandos Powershell para criar um catálogo no VMware:
$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "vmwarecatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"
$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "vmware.local" -IdentityPoolName "vmwarecatalog" -IdentityType "ActiveDirectory"  -NamingScheme "vmware##" -NamingSchemeType "Numeric" -Scope @()
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image2 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = New-ProvScheme -ProvisioningSchemeName vmwarecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName vmware -IdentityPoolName vmwarecatalog -CleanOnBoot -Scope @() -SecurityGroup @() -NetworkMapping @{"0"="XDHyp:\HostingUnits\vmware\\DSwitch-VM Network.network"} -VMCpuCount 2 -VMMemoryMB 4096 -RunAsynchronously
Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName vmwarecatalog
Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid

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]
Ou,
Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
Exemplo do conjunto completo de comandos 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

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 estiver sendo usada por qualquer esquema de provisionamento.
Os passos detalhados são os seguintes:
  1. Remover 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
    Nota:
    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.
  2. Remover 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 -RunAsynchronously
  3. Remover uma versão de imagem. Por exemplo,
    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
  4. Remover uma definição de imagem. Por exemplo,
    Remove-ProvImageDefinition -ImageDefinitionName image1
Exemplo do conjunto completo de comandos PowerShell:
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"
$Task = Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
Remove-ProvImageDefinition -ImageDefinitionName image1

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.
  • Renomear uma definição de imagem usando o comando Rename-ProvImageDefinition. Por exemplo:
    Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
    Ou,
    Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
  • Editar uma definição de imagem usando o comando Set-ProvImageDefinition. Por exemplo:
    Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
    Ou,
    Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
  • Editar uma versão de imagem usando o comando Set-ProvImageVersion. Por exemplo:
    Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
    Ou,
    Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]

Obter detalhes de 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 da imagem usando o comando Get-ProvImageDefinition. Por exemplo:
    Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
  • Obtenha detalhes da versão da imagem usando o comando Get-ProvImageVersion. Por exemplo:
    • Para listar as versões da imagem em uma definição de imagem,
      Get-ProvImageVersion -ImageDefinitionUid <Guid>
      Ou,
      Get-ProvImageVersion -ImageDefinitionName <string>
    • Para obter um detalhe da versão da imagem,
      Get-ProvImageVersion -ImageVersionUid <Guid>
      Ou,
      Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
  • Obtenha a especificação da versão da 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>
    • Para listar as especificações da versão da imagem mestre em uma especificação da versão da imagem preparada,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
    • Para listar as especificações da versão da imagem preparada em uma versão da imagem, que está associada a uma imagem mestre,
      Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
    • 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"'
    • Para obter um detalhe da especificação da versão da imagem preparada,
      Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
  • Obtenha os 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>]
  • Obtenha o histórico da especificação da versão da 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>]