Gerenciar um catálogo do Microsoft Azure

Last published : Nov 13, 2026
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 persistente ou não persistente existente ou a um conjunto de máquinas. 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
      • se você não ligar a máquina, a atualização de configuração não será aplicada
      • se você ligar a máquina, a atualização de configuração será aplicada
    • Se a máquina estiver ligada e
      • se você não reiniciar a máquina, a atualização de configuração não será 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, snapshot 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 esta 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