Gerenciar um catálogo do Microsoft Azure

Last published : Nov 13, 2026
Nota:
Desde julho de 2023, a Microsoft renomeou o Azure Active Directory (Azure AD) para Microsoft Entra ID. Neste documento, qualquer referência a Azure Active Directory, Azure AD ou AAD agora se refere a Microsoft Entra ID.
Gerenciar catálogos de máquinas descreve os assistentes que gerenciam um catálogo de máquinas. As informações a seguir cobrem detalhes específicos dos ambientes de nuvem do Microsoft Azure Resource Manager.
Nota:
Antes de gerenciar um catálogo do Microsoft Azure, você precisa concluir a criação de um catálogo do Microsoft Azure. Consulte Criar um catálogo do Microsoft Azure.
Related information
Gerenciar catálogos de máquinas

Alterar o tipo de armazenamento para um nível inferior quando uma VM é desligada

Você pode economizar custos de armazenamento alterando o tipo de armazenamento de um disco gerenciado para um nível inferior ao desligar uma VM. Para fazer isso, use a propriedade personalizada StorageTypeAtShutdown.
O tipo de armazenamento do disco muda para um nível inferior (conforme especificado na propriedade personalizada StorageTypeAtShutdown) quando você desliga a VM. Depois de ligar a VM, o tipo de armazenamento volta ao original (conforme especificado na propriedade personalizada StorageType ou na propriedade personalizada WBCDiskStorageType).
Importante:
O disco não existe até que a VM seja ligada pelo menos uma vez. Portanto, você não pode alterar o tipo de armazenamento ao ligar a VM pela primeira vez.

Requisitos

  • Aplicável a um disco gerenciado. Isso implica que você define a propriedade personalizada UseManagedDisks como true.
  • Aplicável a um catálogo persistente e não persistente com um disco de SO persistente. Isso implica que você define a propriedade personalizada persistOsDisk como true.
  • Aplicável a um catálogo não persistente com um disco WBC persistente. Isso implica que você define a propriedade personalizada persistWBC como true.

Restrição

  • De acordo com a Microsoft, você só pode alterar o tipo de disco duas vezes por dia. Consulte o documento da Microsoft. De acordo com a Citrix, a atualização StorageType ocorre sempre que há uma ação de Iniciar ou Desalocar para a VM. Portanto, limite o número de ações de energia por VM a duas por dia. Por exemplo, uma ação de energia pela manhã para iniciar a VM e uma à noite para desalocar a VM.

Alterar o tipo de armazenamento para um nível inferior

Antes de prosseguir com as etapas, consulte os Requisitos e a Restrição.
  1. Adicione a propriedade personalizada StorageTypeAtShutdown, defina o valor como Standard_LRS (HDD) e crie um catálogo usando New-ProvScheme. Para obter informações sobre como criar um catálogo usando o PowerShell, consulte <https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/>.
    Nota:
    Se StorageTypeAtShutdown tiver qualquer valor diferente de vazio ou Standard_LRS (HDD), a operação falha.
    Exemplo de configuração de propriedades personalizadas ao criar um catálogo persistente:
    $customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
    <Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
    <Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
    <Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
    <Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
    <Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
    <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
    </CustomProperties>'
    Exemplo de configuração de propriedades personalizadas ao criar um catálogo não persistente:
    $customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
    <Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
    <Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
    <Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
    <Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
    <Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
    <Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
    <Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
    <Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
    <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
    </CustomProperties>'
    Nota:
    Ao usar um perfil de máquina, a propriedade personalizada tem precedência sobre a propriedade definida em MachineProfile.
  2. Desligue a VM e verifique o tipo de armazenamento da VM no portal do Azure. O tipo de armazenamento do disco muda para um nível inferior, conforme especificado na propriedade personalizada StorageTypeAtShutdown.
  3. Ligue a VM. O tipo de armazenamento do disco volta para o tipo de armazenamento mencionado em:
    • propriedade personalizada StorageType para disco do SO
    • propriedade personalizada WBCDiskStorageType para disco WBC somente se você especificá-lo em CustomProperties. Caso contrário, ele volta para o tipo de armazenamento mencionado em StorageType.

Aplicar StorageTypeAtShutdown a um catálogo existente

Antes de prosseguir com as etapas, consulte os Requisitos e a Restrição.
Use Set-ProvScheme para adicionar uma VM a um catálogo existente. O recurso se aplica a novas VMs adicionadas após a execução de Set-ProvScheme. As máquinas existentes não são afetadas.
Exemplo de como definir propriedades personalizadas ao adicionar uma VM a um catálogo existente:
$customProperties='<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="UseManagedDisks" Value="true" />
<Property xsi:type="StringProperty" Name="StorageType" Value="Premium_LRS" />
<Property xsi:type="StringProperty" Name="WbcDiskStorageType" Value="Standard_SSD_LRS" />
<Property xsi:type="StringProperty" Name="ResourceGroups" Value="" />
<Property xsi:type="StringProperty" Name="LicenseType" Value="Windows_Client" />
<Property xsi:type="StringProperty" Name="SchemaVersion" Value="2" />
<Property xsi:type="StringProperty" Name="OsType" Value="Windows" />
<Property xsi:type="BooleanProperty" Name="persistWBC" Value=true />
<Property xsi:type="BooleanProperty" Name="persistOsDisk" Value=true />
<Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
</CustomProperties>'

$ProvScheme = Get-Provscheme -ProvisioningSchemeName $CatalogName

Set-ProvScheme -ProvisioningSchemeName $ProvScheme.ProvisioningSchemeName -CustomProperties $customProperties

Altere o tipo de armazenamento de VMs existentes para um nível inferior no desligamento

Antes de prosseguir com as etapas, consulte os Requisitos e a Restrição.
Você pode economizar custos de armazenamento alterando o tipo de armazenamento das VMs existentes para um nível inferior quando as VMs são desligadas. Para fazer isso, use a propriedade personalizada StorageTypeAtShutdown.
Para alterar o tipo de armazenamento de máquinas existentes em um catálogo para um nível inferior quando as VMs são desligadas:
  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
  3. Execute Get-Provscheme -ProvisioningSchemeName $CatalogName.
  4. Altere a string de propriedades personalizadas.
    $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Property xsi:type="StringProperty" Name="StorageTypeAtShutdown" Value="Standard_LRS" />
    </CustomProperties>'
  5. Atualize o esquema de provisionamento do catálogo existente. A atualização se aplica a novas VMs adicionadas após a execução de Set-ProvScheme.
    Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties
  6. Atualize as VMs existentes para habilitar StorageTypeAtShutdown.
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName $CatalogName -StartsNow -DurationInMinutes -1
  7. Na próxima vez que você ligar as máquinas, a propriedade StorageTypeAtShutdown das máquinas será atualizada. O tipo de armazenamento muda no próximo desligamento.
  8. Execute o seguinte comando para visualizar o valor StorageTypeAtShutdown para cada VM em um catálogo:
    Get-ProvVM -ProvisioningSchemeName <catalog-name> | foreach { $vmName = $_.VMName; $storageTypeAtShutdown = ($_.CustomVmData | ConvertFrom-Json).StorageTypeAtShutdown.DiskStorageAccountType; return New-Object psobject -Property @{ "VMName" = $vmName; "StorageTypeAtShutdown" = $storageTypeAtShutdown } }

Atualizar máquinas provisionadas para o estado atual do esquema de provisionamento

O comando Set-ProvScheme altera o esquema de provisionamento. No entanto, ele não afeta as máquinas existentes. Usando o comando PowerShell Set-ProvVMUpdateTimeWindow, você pode aplicar o esquema de provisionamento atual a uma máquina ou conjunto de máquinas existente, persistente ou não persistente. Você também pode agendar um período de tempo para as atualizações de configuração das máquinas provisionadas pelo MCS existentes. Qualquer inicialização ou reinicialização durante o período de tempo agendado aplica uma atualização de esquema de provisionamento agendada a uma máquina. Atualmente, no Azure, você pode atualizar ServiceOffering, MachineProfile e as seguintes propriedades personalizadas:
  • StorageType
  • WBCDiskStorageType
  • IdentityDiskStorageType
  • LicenseType
  • DedicatedHostGroupId
  • PersistWBC
  • PersistOsDisk
  • PersistVm
Nota:
  • Você só pode atualizar as propriedades personalizadas StorageType, WBCDiskStorageType e IdentityDiskStorageType para um catálogo usando disco gerenciado em ambientes Azure.
  • Se você executar Set-ProvVMUpdateTimeWindow duas vezes, o comando mais recente terá efeito.
Você pode atualizar:
  • Uma única VM
  • Uma lista de VMs específicas ou todas as VMs existentes associadas a um ID de esquema de provisionamento
  • Uma lista de VMs específicas ou todas as VMs existentes associadas a um nome de esquema de provisionamento (nome do catálogo de máquinas)
Depois de fazer as seguintes alterações no esquema de provisionamento, a instância da VM é recriada para catálogos persistentes no Azure:
  • Alterar o MachineProfile
  • Remover LicenseType
  • Remover DedicatedHostGroupId
Nota:
O disco do SO das máquinas existentes, juntamente com todos os seus dados, permanece como está e uma nova VM é anexada ao disco.
Antes de atualizar as VMs existentes:
  1. Verifique a configuração das máquinas existentes. Por exemplo,
    Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
  2. Atualize o esquema de provisionamento. Por exemplo,
    • Com a VM como entrada de perfil de máquina:
      Set-ProvScheme -ProvisioningSchemeName "my-catalog" -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<virtual-machine>.vm"
    • Com a especificação de modelo como entrada de perfil de máquina:
      Set-ProvScheme -ProvisioningSchemeName "my-catalog"
      -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
      -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
    • Apenas com a oferta de serviço:
      Set-ProvScheme -ProvisioningSchemeName "my-catalog" -ServiceOffering "XDHyp:\HostingUnits\<hosting-unit>\serviceoffering.folder\<service-offering>.serviceoffering"
  3. Verifique se a propriedade atual da VM corresponde ao esquema de provisionamento atual e se há alguma ação de atualização pendente na VM. Por exemplo,
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
    Você também pode encontrar máquinas com uma versão específica. Por exemplo,
    Get-ProvVM -Filter "ProvisioningSchemeVersion -eq 1" | select VMName, ProvisioningSchemeVersion
Para solicitar atualizações para máquinas existentes que serão aplicadas na próxima reinicialização:
  1. Execute os seguintes comandos para atualizar as máquinas existentes e fazer com que as atualizações sejam aplicadas na próxima reinicialização.
    • Para atualizar todas as máquinas existentes. Por exemplo,
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
    • Para atualizar uma lista de máquinas específicas. Por exemplo,
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName <List-Of-Vm-Names> -StartsNow -DurationInMinutes -1
    • Para atualizar máquinas com base na saída de Get-ProvVM. Por exemplo,
      Get-ProvVM -ProvisioningSchemeName "my-catalog" | Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
    Nota:
    • StartsNow indica que a hora de início agendada é a hora atual.
    • DurationInMinutes com um número negativo (por exemplo, –1) indica que não há limite superior para a janela de tempo do agendamento.
  2. Encontre máquinas com uma atualização agendada. Por exemplo,
    Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
  3. Reinicie as máquinas. No próximo ligamento, as alterações de propriedade são aplicadas às máquinas existentes. Você pode verificar o status atualizado usando o seguinte comando. Por exemplo,
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeVersion
Para agendar uma VM para atualizar para as configurações de provisionamento mais recentes na próxima vez que ela iniciar na janela de tempo agendada:
  1. Execute os seguintes comandos:
    • Para agendar uma atualização com a hora de início como a hora atual
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName vm1 -StartsNow -DurationInMinutes 120
    • Para agendar uma atualização em um fim de semana
      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1” -StartTimeInUTC “10/15/2022 9:00am” -DurationInMinutes (New –TimeSpan –Days 2).TotalMinutes
    Nota:
    • VMName é opcional. Se não for especificado, a atualização é agendada para todo o catálogo.
    • Em vez de StartTimeInUTC, use StartsNow para indicar que a hora de início do agendamento é a hora atual.
    • DurationInMinutes é opcional. O padrão é 120 minutos. Um número negativo (por exemplo, –1) indica que não há limite superior para a janela de tempo do agendamento.
  2. Verifique o status da atualização.
    Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeUpdateUntil, ProvisioningSchemeVersion
  3. Ligue a VM. Se você ligar a máquina após o período agendado, a atualização da configuração não será aplicada. Se você ligar a máquina dentro do período agendado,
    • Se a máquina estiver desligada e
      • você não liga a máquina, a atualização de configuração não é aplicada
      • você liga a máquina, a atualização de configuração é aplicada
    • Se a máquina estiver ligada e
      • você não reinicia a máquina, a atualização da configuração não é aplicada
      • você reinicia a máquina, a atualização da configuração é aplicada
Para cancelar a atualização da configuração:
Você também pode cancelar uma atualização de configuração de uma única VM, de várias VMs ou de um catálogo inteiro. Para cancelar uma atualização de configuração:
  1. Execute Clear-ProvVMUpdateTimeWindow. Por exemplo:
    • Para cancelar a atualização da configuração agendada para uma única VM:
      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
    • Para cancelar a atualização da configuração agendada para várias VMs:
      Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
      Nota:
      As VMs devem ser do mesmo catálogo.

Atualizar propriedades de VMs individuais

Você pode atualizar as propriedades de VMs individuais em um catálogo de máquinas MCS persistente usando o comando PowerShell Set-ProvVM. No entanto, as atualizações não são aplicadas imediatamente. Você deve definir a janela de tempo usando o comando PowerShell Set-ProvVMUpdateTimeWindow para que as atualizações sejam aplicadas.
Esta implementação ajuda você a gerenciar VMs individuais de forma eficiente sem atualizar todo o catálogo de máquinas. Atualmente, este recurso é aplicável apenas ao ambiente Azure.
Atualmente, as propriedades que você pode atualizar são:
  • CustomProperties
  • ServiceOffering
  • MachineProfile
Usando este recurso, você pode:
Antes de atualizar as propriedades de uma VM:
  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
  3. Verifique a configuração do catálogo de máquinas existente. Por exemplo:
    Get-ProvScheme -ProvisioningSchemeName AzureCatalog
  4. Verifique a configuração da VM na qual você deseja aplicar as atualizações. Por exemplo:
    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

Atualizar propriedades de uma VM

Faça o seguinte para atualizar as propriedades em uma VM:
  1. Desligue a VM na qual você deseja aplicar as atualizações.
  2. Atualize as propriedades da VM. Por exemplo, se você quiser atualizar a propriedade personalizada do tipo de armazenamento (StorageType) da VM, execute o seguinte:
    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
    Você pode atualizar as propriedades de duas VMs em um catálogo de máquinas simultaneamente. Por exemplo:
    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
    Observação:
    As atualizações não são aplicadas imediatamente.
  3. Obtenha a lista de propriedades que devem ser atualizadas e a versão da configuração. Por exemplo:
    Get-ProvVMConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
    Verifique o valor da propriedade de Version e as propriedades a serem atualizadas (neste caso, StorageType).
  4. Verifique a versão da configuração. Por exemplo:
    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    Verifique o valor da propriedade de ProvVMConfigurationVersion. A atualização ainda não foi aplicada. A VM ainda está na configuração antiga.
  5. Solicite a atualização agendada. Por exemplo:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -StartsNow -DurationInMinutes -1
    Para obter mais informações sobre atualizações agendadas, consulte Atualizar máquinas provisionadas para o estado atual do esquema de provisionamento.
    Observação:
    Qualquer atualização pendente do esquema de provisionamento também é aplicada.
  6. Reinicie a VM. Por exemplo:
    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
  7. Verifique a versão da configuração. Por exemplo:
    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    Verifique o valor da propriedade de ProvVMConfigurationVersion. A atualização agora foi aplicada. A VM agora tem a nova configuração.
  8. Para aplicar mais atualizações de configuração na VM, desligue a VM e repita os passos.

Manter as propriedades atualizadas em uma VM após a atualização do catálogo de máquinas

Faça o seguinte para manter as propriedades atualizadas em uma VM:
  1. Desligue a VM na qual você deseja aplicar as atualizações.
  2. Atualize o catálogo de máquinas. Por exemplo, se você quiser alterar o tamanho da VM (ServiceOffering) e o tipo de armazenamento (StorageType), execute o seguinte:
    Set-ProvScheme -ProvisioningSchemeName AzureCatalog -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
  3. Obtenha os detalhes de configuração do catálogo de máquinas. Por exemplo:
    Get-ProvScheme -ProvisioningSchemeName AzureCatalog
    O ProvisioningSchemeVersion agora é incrementado em um. O tamanho da VM e o tipo de armazenamento também são atualizados.
  4. Atualize as propriedades da VM. Por exemplo, forneça um perfil de máquina para a VM.
    Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
    Observação:
    A entrada do perfil da máquina tem uma tag e um tamanho de VM diferente (ServiceOffering) especificado.
  5. Obtenha a lista de propriedades que a VM terá após mesclar as atualizações de configuração na VM com as atualizações do catálogo de máquinas. Por exemplo:
    Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName AzureCatalog -VMName machine1
    Observação:
    Quaisquer atualizações na VM substituirão as atualizações feitas no catálogo de máquinas.
  6. Solicite atualização agendada para a VM. Por exemplo:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
  7. Reinicie a VM. Por exemplo:
    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
    A VM mantém seu tamanho de VM atualizado conforme derivado do perfil da máquina. Os valores de tag especificados no perfil da máquina também são aplicados à VM. No entanto, o tipo de armazenamento é derivado do esquema de provisionamento mais recente.
  8. Obtenha a versão de configuração da VM. Por exemplo:
    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    O ProvisioningSchemeVersion e o ProvVMConfigurationVersion agora mostram a versão mais recente.

Reverter as atualizações de configuração aplicadas a uma VM

  1. Após aplicar as atualizações a uma VM, desligue a VM.
  2. Execute o seguinte comando para remover as atualizações aplicadas na VM. Por exemplo:
    Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
  3. Solicite atualização agendada para a VM. Por exemplo:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
  4. Reinicie a VM. Por exemplo:
    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
  5. Verifique a versão de configuração da VM. Por exemplo:
    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    O valor ProvVMConfigurationVersion agora é a versão de configuração do catálogo de máquinas.

Recuperar informações para VMs do Azure, snapshots, disco do SO e definição de imagem da galeria

Você pode exibir informações para uma VM do Azure, incluindo disco e tipo de SO, instantâneo e definição de imagem da galeria. Essas informações são exibidas para recursos na imagem mestre quando um catálogo de máquinas é atribuído. Use essa funcionalidade para visualizar e selecionar uma imagem Linux ou Windows. Uma propriedade do PowerShell, TemplateIsWindowsTemplate, foi adicionada ao parâmetro AdditionDatafield. Este campo contém informações específicas do Azure: tipo de VM, disco do SO, informações da imagem da galeria e informações do tipo de SO. Definir TemplateIsWindowsTemplate como True indica que o tipo de SO é Windows; definir TemplateIsWindowsTemplate como False indica que o tipo de SO é Linux.
Dica:
As informações exibidas pela propriedade PowerShell TemplateIsWindowsTemplate são derivadas da API do Azure. Às vezes, este campo pode estar vazio. Por exemplo, um snapshot de um disco de dados não contém o campo TemplateIsWindowsTemplate porque o tipo de SO não pode ser recuperado de um snapshot.
Por exemplo, defina o parâmetro AdditionData da VM do Azure como True para o tipo de SO Windows usando o PowerShell:
PS C:\Users\username> (get-item XDHyp:\HostingUnits\mynetwork\image.folder\username-dev-testing-rg.resourcegroup\username-dev-tsvda.vm).AdditionalData
Key Value
ServiceOfferingDescription Standard_B2ms
HardDiskSizeGB 127
ResourceGroupName FENGHUAJ-DEV-TESTING-RG
ServiceOfferingMemory 8192
ServiceOfferingCores 2
TemplateIsWindowsTemplate True
ServiceOfferingWithTemporaryDiskSizeInMb 16384
SupportedMachineGenerations Gen1,Gen2

Identificar recursos criados pelo MCS

A seguir estão as tags que o MCS adiciona aos recursos. As tags na tabela são representadas como "key":"value".
Nome do recurso Tag
Disco de ID "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
Imagem "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
NIC "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
Disco do SO "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
PrepVM "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
Instantâneo publicado "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
Grupo de recursos "CitrixResource" : "Internal"
CitrixSchemaVersion: 2.0
"CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Conta de armazenamento "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
VM no catálogo "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
Disco WBC "CitrixProvisioningSchemeId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
"CitrixResource" : "Internal"
Nota:
Uma VM não fica visível no inventário do Citrix se uma tag CitrixResource for adicionada para identificá-la como um recurso criado pelo MCS. Você pode remover ou renomear a tag para torná-la visível.

Mais informações