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

Gerenciamento de imagens (prévia)

August 22, 2024
Contribuição de: 
C

Introdução

O processo de criação ou atualização do catálogo do 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 do MCS (imagem preparada) a partir de uma única imagem de origem e usá-la em vários catálogos de máquinas do MCS diferentes. Essa implementação reduz significativamente os custos de armazenamento e tempo e simplifica o processo de implantação da VM e de atualização de imagens.

Os benefícios de usar essa funcionalidade de gerenciamento de imagens são:

  • Gere imagens preparadas com antecedência sem criar um catálogo.
  • Reutilize imagens preparadas em vários cenários, como criar e atualizar um catálogo.
  • Reduza significativamente o tempo de criação ou atualização do catálogo.

Nota:

  • Atualmente, esse recurso é aplicável aos ambientes de virtualização do Azure e da VMware.
  • Você pode criar um catálogo de máquinas do MCS sem usar imagens preparadas. Nesse caso, você não pode obter os benefícios do recurso.

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ê:

    • gerencie diferentes iterações ou atualizações em uma imagem específica.
    • mantenha várias versões de uma imagem para finalidades diferentes.

  • Agrupamento lógico — Você pode criar várias definições de imagem para:

    • agrupar logicamente versões de imagens com base em vários critérios, como projeto, departamento ou aplicativo e tipo de área de trabalho.
    • gerenciar imagens com mais eficiência dentro de uma organização.

O que é uma imagem preparada?

Com a funcionalidade de gerenciamento de imagens, o MCS separa a fase de masterização do fluxo de trabalho geral de criação ou atualização do catálogo e divide o processo em dois estágios:

  1. Crie imagens preparadas a partir de uma única imagem de origem.
  2. Use a imagem preparada para criar ou atualizar um catálogo de máquinas do 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 do MCS quando você usa 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 que serve o sistema operacional
  • outras informações sobre o uso da imagem.

Um catálogo não é criado a partir de uma definição de imagem, mas 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 as versões para a definição de imagem. Uma definição de imagem pode ter várias versões de imagem. Use as versões de imagem como imagens preparadas para criar ou atualizar um catálogo.

Como alternativa, se você quiser usar os comandos do PowerShell para criar um esquema de provisionamento para criar ou atualizar um catálogo, deverá criar uma especificação de versão de imagem preparada com base na especificação de versão da imagem mestre, conforme necessário para seu ambiente.

Participar do Tech Preview

Se você estiver interessado em participar do Tech Preview, forneça suas informações de contato aqui.

Ajudaremos você a configurar o ambiente de teste e forneceremos suporte técnico, se necessário.

Requisito

  • Para a imagem mestre do Windows, somente imagens do VDA com a versão 2311 e posterior e o MCS/IO habilitado são permitidas.

Limitações

Atualmente, o recurso não oferece suporte ao seguinte:

  • Várias NICs no Azure
  • Recurso de disco de dados persistente
  • Hibernação para várias sessões
  • Alteração do tipo de imagem

Gerenciamento do ciclo de vida de imagens usando o Web Studio

O ciclo de vida da imagem quando você usa o Web Studio é:

  1. Crie uma imagem preparada: crie uma definição de imagem e sua versão inicial da imagem.
  2. Crie versões de imagem a partir da versão inicial da imagem.
  3. Use uma versão de imagem como uma imagem preparada para criar catálogos.
  4. Atualize um catálogo de máquinas com uma imagem preparada diferente.
  5. Gerencie as definições e versões da imagem: edite o nome e a descrição das versões da imagem e a descrição de uma definição de imagem.
  6. Exclua uma versão da imagem.
  7. Exclua uma definição de imagem.

Como alternativa, você também pode gerenciar imagens usando o PowerShell. Consulte Gerenciamento do ciclo de vida de imagens 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 do MCS usando:

Usar o Web Studio

Veja os tópicos a seguir:

Entender o nó Imagens

Use o nó Imagens para criar e gerenciar imagens preparadas pelo MCS. Sua visão principal é dividida em quatro partes:

image-node-main-view

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 mestre, recurso, hipervisor, nome da definição de imagem, tipo de sistema operacional 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 da imagem selecionada.
D Barra de ação Lista as ações que você pode realizar nas 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 do MCS usando a imagem preparada são:

  1. Crie a definição de 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 uma versão inicial da imagem

Para criar uma definição de imagem e a versão inicial da imagem, faça o seguinte:

  1. Entre no Web Studio e selecione o nó Imagens. Clique em Avançar na página de introdução.
  2. Na página Definição de imagem, especifique o Tipo de sistema operacional e o Tipo de sessão para a definição de 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 selecione um perfil de máquina.

    Nota:

    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.

    Nota:

    Se você selecionar um perfil de máquina na página Imagem, o tipo de licença do perfil da máquina será pré-selecionado com base na configuração do perfil.

  5. Na página Especificações da máquina:

    • Para o 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 da máquina será selecionado por padrão.
    • Para a VMware, se você selecionar um perfil de máquina, poderá ver a contagem de CPUs virtuais derivada do perfil da máquina e ela permanecerá inalterável. Se você não selecionar um perfil de máquina, poderá ver somente 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 a 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á imutável.

    Nota:

    Várias NICs não são permitidas no Azure.

  7. (Somente para Azure) Na página Configurações do disco, selecione a chave de criptografia gerenciada pelo cliente (CMEK). Se o perfil de 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 de imagem e da versão inicial da imagem criada. Insira um nome e uma descrição para a definição de imagem. Clique em Finish.

Criar versões de imagem

As versões de imagem permitem o gerenciamento de diferentes iterações ou atualizações em uma imagem específica. Essa funcionalidade permite que você mantenha várias versões de uma imagem para finalidades diferentes.

Para criar versões de imagem a partir da versão inicial da imagem, faça o seguinte:

Nota:

A unidade de hospedagem de todas as versões da imagem deve ser a mesma.

  1. Vá até 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 de imagem seja diferente da versão inicial da imagem configurada, defina as configurações nas páginas Imagem, Armazenamento e tipos de licença, Especificação da máquina, NICs e Configurações do disco da caixa de diálogo Criar versão da imagem.
  3. Adicione uma descrição para a versão da imagem. Clique em Finish.

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.

Como alternativa, você pode selecionar a versão ao criar um catálogo no nó Catálogos de computadores, vinculando à opção de imagem preparada no fluxo de trabalho de criação do catálogo. Consulte Criar um catálogo de máquinas a partir do nó Catálogos de computadores

Para criar um catálogo de máquinas do 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 de introdução.
  2. Na página Experiência de área de trabalho, selecione a experiência de área de trabalho necessária.
  3. Da página Imagem até a página Configurações do 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 escolher criar um novo grupo de recursos ou usar um grupo de recursos existente para colocar os recursos desse catálogo.
  5. Conclua as configurações nas páginas a seguir.
  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 Finish.
  7. Acesse o nó Catálogos de computadores para ver o catálogo de máquinas criado.

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

Para criar um catálogo de máquinas do MCS a partir do nó Catálogos de computadores, faça o seguinte:

  1. Clique em Catálogos de computadores 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 da imagem de uma definição de imagem.
    3. Clique no nome da versão da imagem. Para exibir 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. Defina as configurações nas páginas a seguir.
  5. Na página Configurações do 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 escolher criar um novo grupo de recursos ou usar um grupo de recursos existente para colocar os recursos desse catálogo.
  7. Conclua as configurações nas páginas a seguir.
  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 Finish.

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

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

  1. Clique em Catálogos de computadores 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.
  3. Na página Estratégia de implantação, selecione quando você deseja atualizar esse catálogo com a imagem preparada selecionada.
  4. Na página Resumo, verifique os detalhes. Clique em Finish.

Você pode ver o histórico das 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 da 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 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 nó Imagens, selecione uma versão da imagem e selecione Excluir versão da imagem.

Nota:

Você não poderá excluir uma versão da 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:

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

Gerenciamento do ciclo de vida de imagens usando o PowerShell

Se você quiser usar os comandos do PowerShell para criar um esquema de provisionamento, deverá criar uma especificação de versão da imagem preparada com base na especificação de versão da 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 sob uma versão da imagem. Você pode adicionar uma imagem existente no hipervisor como especificação de versão da imagem mestre ou criar uma especificação de versão da imagem preparada com base na especificação de versão da imagem mestre, conforme necessário para seu ambiente. A especificação da versão da imagem preparada pode ser usada para vários esquemas de provisionamento.

O ciclo de vida de uma imagem durante o uso dos comandos do PowerShell é:

  1. Crie uma imagem:

    1. Crie uma definição de imagem.
    2. Crie uma versão da imagem.
    3. Adicione uma especificação de versão da imagem mestre.
    4. Crie uma especificação de versão da imagem preparada.

  2. Crie um catálogo de máquinas do MCS usando uma especificação de versão de imagem preparada:

    1. Crie um catálogo de agentes.
    2. Crie um pool de identidades.
    3. Crie um esquema de provisionamento com o parâmetro da especificação de versão da imagem preparada Uid usando o comando New-ProvScheme.
    4. Vincule o catálogo de agentes ao esquema de provisionamento.
  3. Crie VMs no catálogo de máquinas do MCS.
  4. Altere a especificação da versão da imagem preparada de um esquema de provisionamento usando o comando Set-ProvScheme.
  5. Gerencie as definições e versões de imagem: edite as versões e definições de imagem.
  6. Exclua um catálogo de máquinas do MCS: a ordem de exclusão é: especificação da versão da imagem preparada > especificação da versão da imagem mestre > versão da imagem > definição de imagem. Antes de excluir a especificação da versão da imagem, certifique-se de que a especificação da versão da imagem preparada não esteja associada a nenhum catálogo de máquinas do MCS.

Usar o PowerShell

Você pode fazer o seguinte usando os comandos do PowerShell:

Criar uma imagem preparada

Os comandos detalhados do PowerShell para criar uma especificação de versão da imagem preparada são os seguintes:

  1. Verifique os nomes de definição de imagem disponíveis usando o Test-ProvImageDefinitionNameAvailable command. Por exemplo,

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

  2. Crie uma definição de imagem usando o comando New-ProvImageDefinition. Por exemplo,

    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
<!--NeedCopy-->

  3. Crie uma versão da imagem usando o comando New-ProvImageVersion. Por exemplo,

    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
<!--NeedCopy-->

  4. Adicione uma especificação de versão da 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"
<!--NeedCopy-->

    Nota:

    Você pode adicionar somente uma especificação de versão da imagem mestre a uma versão da imagem para uma unidade de hospedagem.

  5. Crie uma especificação de versão da imagem preparada a partir da especificação de versão da 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
<!--NeedCopy-->

    Nota:

    Uma unidade de hospedagem e um tipo de preparação podem ter somente uma instância preparada.

Exemplo do conjunto completo de comandos do Powershell para criar a definição de imagem, a versão da imagem e a especificação de versão da 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
<!--NeedCopy-->

Exemplo do conjunto completo de comandos do Powershell para criar a definição de imagem, a versão da imagem e a especificação de versão da imagem preparada na 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
<!--NeedCopy-->

Nota:

  • Todas as especificações da versão da imagem em uma definição de imagem devem pertencer à mesma unidade de hospedagem.
  • Uma versão da imagem pode ter somente uma especificação de versão da imagem mestre e uma especificação de versão da imagem preparada.
  • Todas as especificações da versão da imagem devem ter um perfil de máquina ou nenhuma das especificações da versão da imagem deve ter um perfil de máquina.
  • Você não pode especificar um grupo de recursos ao criar uma especificação de versão da imagem.

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

Crie um catálogo de máquinas do MCS a partir da especificação da versão da 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>]
<!--NeedCopy-->

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>]
<!--NeedCopy-->

Exemplo do conjunto completo de comandos do 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
<!--NeedCopy-->

Exemplo do conjunto completo de comandos do Powershell para criar um catálogo na 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
<!--NeedCopy-->

Atualizar um catálogo usando uma especificação de versão da 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 a definição da imagem, a versão da imagem e a especificação da versão da imagem preparada

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

  • Uma definição de imagem não poderá ser excluída se ela contiver qualquer versão da imagem.
  • Uma versão da imagem não poderá ser excluída se ela contiver qualquer especificação de versão da imagem.
  • Uma especificação de versão da imagem mestre não poderá ser excluída se for usada por qualquer outra especificação de versão da imagem preparada.
  • Uma especificação de versão da imagem preparada não poderá ser excluída se for usada por qualquer esquema de provisionamento.

As etapas detalhadas são as seguintes:

  1. Remova uma especificação de versão da imagem preparada. Por exemplo,

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

    Nota:

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

  2. 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 -RunAsynchronously
<!--NeedCopy-->

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

    Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1
<!--NeedCopy-->

  4. Remova uma definição de imagem. Por exemplo,

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

Exemplo do conjunto completo de comandos do 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
<!--NeedCopy-->

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

Você pode renomear e editar uma definição de imagem e editar uma versão da 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 da 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 a definição de imagem, a versão da imagem, a especificação da versão da imagem preparada e os detalhes do 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 da imagem usando o comando Get-ProvImageVersion. Por exemplo:

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

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

      Ou,

       Get-ProvImageVersion -ImageDefinitionName <string>
 <!--NeedCopy-->

    • Para obter detalhes da versão da imagem,

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

      Ou,

       Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
 <!--NeedCopy-->

  • Prepare a especificação da versão da imagem usando o comando Get-ProvImageVersionSpec. Por exemplo:

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

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

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

       Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"'
 <!--NeedCopy-->

    • 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"'
 <!--NeedCopy-->

    • Para obter especificações de versão da imagem preparada com sucesso em uma versão da 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 da versão da 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-->

  • Prepare o histórico de especificações da versão da imagem 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-->
Gerenciamento de imagens (prévia)
August 22, 2024
Contribuição de: 
C
August 22, 2024
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.