Citrix DaaS

Gerenciar um catálogo do Microsoft Azure

December 20, 2023

Contribuição de:

Gerenciar catálogos de máquinas descreve os assistentes que gerenciam um catálogo de máquinas. As informações a seguir abrangem 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.

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

Você pode economizar nos custos de armazenamento mudando o tipo de armazenamento de um disco gerenciado para um nível inferior ao desligar uma VM. Para fazer isso, use a propriedade StorageTypeAtShutdown personalizada.

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 StorageType personalizada ou na propriedade WBCDiskStorageType personalizada).

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.

A máquina virtual pode demorar um pouco mais para começar depois que você alterar o tipo de armazenamento para um nível inferior.

Requisitos

Aplicável a um disco gerenciado. Isso implica que você defina a propriedade personalizada UseManagedDisks como true.
Aplicável a um catálogo persistente e não persistente com um disco de sistema operacional permanente. Isso implica que você defina a propriedade personalizada persistOsDisk como true.
Aplicável a um catálogo não persistente com um disco WBC persistente. Isso implica que você defina 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 de StorageType acontece 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 vezes por dia. Por exemplo, uma ação de energia pela manhã para iniciar a VM e outra à 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 as Restrições.

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 falhará.

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

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

Nota:

Quando você usa um perfil de máquina, a propriedade personalizada tem precedência sobre a propriedade definida em MachineProfile.

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 StorageTypeAtShutdown personalizada.
Ligue a VM. O tipo de armazenamento do disco volta para o tipo de armazenamento mencionado em:
- Propriedade personalizada StorageType para disco do sistema operacional
- Propriedade personalizada WBCDiskStorageType para o disco WBC somente se você especificar 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 as Restrições.

Use Set-ProvScheme para aplicar StorageTypeAtShutdown às novas VMs adicionadas a um catálogo existente.

Exemplo de configuração de 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
<!--NeedCopy-->

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

Antes de prosseguir com as etapas, consulte os Requisitos e as Restrições.

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 alterar o tipo de armazenamento das máquinas existentes em um catálogo para um nível inferior quando as VMs são desligadas:

Abra uma janela do PowerShell.
Execute o comando asnp citrix* para carregar os módulos do PowerShell específicos da Citrix.
Execute Get-Provscheme -ProvisioningSchemeName $CatalogName.

Altere a cadeia de caracteres das 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>'
<!--NeedCopy-->

Atualize o esquema de provisionamento do catálogo existente. A atualização se aplica às novas VMs adicionadas após a execução de Set-ProvScheme.
```
Set-ProvScheme -ProvisioningSchemeName $CatalogName -CustomProperties $customProperties

```

Atualize as VMs existentes para habilitar StorageTypeAtShutdown.

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

Quando você ligar as máquinas na próxima vez, a propriedade StorageTypeAtShutdown das máquinas será atualizada. O tipo de armazenamento muda no próximo desligamento.

Execute o comando a seguir para visualizar o valor StorageTypeAtShutdown de 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 } }
<!--NeedCopy-->

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

O comando Set-ProvScheme altera o esquema de provisionamento. No entanto, isso não afeta as máquinas existentes. Usando o comando Set-ProvVMUpdateTimeWindow do PowerShell, 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 horário para as atualizações de configuração das máquinas provisionadas pelo MCS existentes. Qualquer ativação ou reinicialização durante o horário programado aplica uma atualização programada do esquema de provisionamento 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 de um catálogo usando o disco gerenciado em ambientes do Azure.

Se você executar Set-ProvVMUpdateTimeWindow duas vezes, o comando mais recente entrará em vigor.

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 de VM é recriada para catálogos persistentes no Azure:

Altere o MachineProfile
Remova LicenseType
Remova DedicatedHostGroupId

Nota:

O disco do sistema operacional 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:

Verifique a configuração das máquinas existentes. Por exemplo,

Get-ProvScheme | select ProvisioningSchemeName, ProvisioningSchemeVersion
<!--NeedCopy-->

Atualize o esquema de provisionamento. Por exemplo,

Com a VM como entrada do perfil da máquina:

 Set-ProvScheme -ProvisioningSchemeName "my-catalog" -MachineProfile "XDHyp:\HostingUnits<hosting-unit>\machineprofile.folder<resource-group>.resourcegroup<virtual-machine>.vm"
 <!--NeedCopy-->

Com a especificação do modelo como entrada do perfil da 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"
 <!--NeedCopy-->

Com apenas a oferta do serviço:

 Set-ProvScheme -ProvisioningSchemeName "my-catalog" -ServiceOffering "XDHyp:\HostingUnits<hosting-unit>\serviceoffering.folder<service-offering>.serviceoffering"
 <!--NeedCopy-->

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 que atualizações sejam aplicadas na próxima reinicialização das máquinas existentes:

Execute os comandos a seguir 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 programada é a hora atual.
- DurationInMinutes com um número negativo (por exemplo, —1) indica que não há limite superior na janela de tempo do cronograma.

Encontre máquinas com uma atualização agendada. Por exemplo,

Get-ProvVM -Filter "ProvisioningSchemeUpdateAfter" | select VMName, ProvisioningSchemeUpdateAfter
<!--NeedCopy-->

Reinicialize as máquinas. Na próxima vez que forem ligadas, as alterações às propriedades serã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 programar a atualização de uma VM com as configurações de provisionamento mais recentes na próxima vez que ela for iniciada na janela do horário agendado.

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 especificada, a atualização será 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 na janela de tempo do cronograma.

Verifique o status da atualização.

Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeUpdateUntil, ProvisioningSchemeVersion
<!--NeedCopy-->

Ligue a VM. Se você ligar a máquina após o horário programado, a atualização da configuração não será aplicada. Se você ligar a máquina dentro do horário programado,
- Se a máquina estiver desligada, e
  - você não ligar a máquina, a atualização de configuração não é aplicada
  - você ligar a máquina, a atualização de configuração é aplicada
- Se a máquina estiver ligada, e
  - você não reiniciar a máquina, a atualização de configuração não é aplicada
  - você reiniciar a máquina, a atualização de configuração é aplicada

Para cancelar a atualização de configuração:

Você também pode cancelar uma atualização de configuração de uma única VM, várias VMs ou um catálogo inteiro. Para cancelar uma atualização de configuração:

Execute Clear-ProvVMUpdateTimeWindow. Por exemplo:

Para cancelar a atualização de configuração agendada de uma única VM:

 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”
 <!--NeedCopy-->

Para cancelar a atualização de configuração agendada de várias VMs:

  Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"
 <!--NeedCopy-->

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 persistentes usando o comando Set-ProvVM do PowerShell. No entanto, as atualizações não são aplicadas imediatamente. Você deve definir a janela de tempo usando o comando Set-ProvVMUpdateTimeWindow do PowerShell para que as atualizações sejam aplicadas.

Essa implementação ajuda você a gerenciar VMs individuais de forma eficiente sem atualizar todo o catálogo de máquinas. Atualmente, esse recurso é aplicável somente ao ambiente do Azure.

Atualmente, as propriedades que você pode atualizar são:

CustomProperties
ServiceOffering
MachineProfile

Usando esse recurso, você pode:

Atualizar as propriedades de uma VM
Manter as propriedades atualizadas em uma VM após a atualização do catálogo de máquinas
Reverter as atualizações de configuração aplicadas a uma VM

Antes de atualizar as propriedades de uma VM:

Abra uma janela do PowerShell.
Execute o comando asnp citrix* para carregar os módulos do PowerShell específicos da Citrix.
Verifique a configuração do catálogo de máquinas existente. Por exemplo:
```
Get-ProvScheme -ProvisioningSchemeName AzureCatalog

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

Desative a VM na qual você deseja aplicar as atualizações.

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

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

Set-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
<!--NeedCopy-->

Nota:

As atualizações não são aplicadas imediatamente.

Obtenha a lista de propriedades especificadas para serem atualizadas e a versão da configuração. Por exemplo:
```
Get-ProvVMConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Verifique o valor da propriedade Version e as propriedades a serem atualizadas (nesse caso, StorageType).
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.
Solicite uma 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.

Nota:

Qualquer atualização pendente do esquema de provisionamento também é aplicada.

Reinicie a VM. Por exemplo:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
<!--NeedCopy-->

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 está aplicada. A VM agora tem a nova configuração.
Para aplicar mais atualizações de configuração na VM, desligue-a e repita as etapas.

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:

Desative a VM na qual você deseja aplicar as atualizações.

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

Obtenha os detalhes de configuração do catálogo de máquinas. Por exemplo:
```
Get-ProvScheme -ProvisioningSchemeName AzureCatalog

```
Agora, ProvisioningSchemeVersion é incrementado em um. O tamanho da VM e o tipo de armazenamento também são atualizados.

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

Nota:

A entrada do perfil da máquina tem uma tag e um tamanho de VM diferente (ServiceOffering) especificado.

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

```
Nota:

Qualquer atualização na VM substituirá as atualizações feitas no catálogo de máquinas.

Solicite uma atualização agendada para a VM. Por exemplo:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

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 da tag, conforme especificado no perfil da máquina, também são aplicados à VM. No entanto, o tipo de armazenamento é derivado do esquema de provisionamento mais recente.
Obtenha a versão de configuração da VM. Por exemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Agora, ProvisioningSchemeVersion e ProvVMConfigurationVersion mostram a versão mais recente.

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

Depois de aplicar as atualizações a uma VM, desligue-a.

Execute o comando a seguir para remover as atualizações aplicadas à VM. Por exemplo:

Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName AzureCatalog -VMName machine1
<!--NeedCopy-->

Solicite uma atualização agendada para a VM. Por exemplo:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName AzureCatalog -VMName machine1 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

Reinicie a VM. Por exemplo:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
<!--NeedCopy-->

Verifique a versão de configuração da VM. Por exemplo:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

```
Agora, o valor ProvVMConfigurationVersion é a versão de configuração do catálogo de máquinas.

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

Você pode exibir informações para uma VM do Azure, incluindo disco de SO e tipo, 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 exibir e selecionar uma imagem do Linux ou do Windows. Uma propriedade do PowerShell, TemplateIsWindowsTemplate, foi adicionada ao parâmetro AdditionDatafield. Esse campo contém informações específicas do Azure: tipo de VM, disco de SO, informações da imagem da galeria e informações do tipo do sistema operacional. Se TemplateIsWindowsTemplate for definido como True, isso indica que o tipo de sistema operacional é Windows; se TemplateIsWindowsTemplate for definido como False, isso indica que o tipo de sistema operacional é Linux.

Dica:

As informações exibidas pela propriedade do TemplateIsWindowsTemplate PowerShell são derivadas da API do Azure. Às vezes, esse campo pode estar vazio. Por exemplo, um instantâneo de um disco de dados não contém o campo TemplateIsWindowsTemplate porque o tipo de sistema operacional não pode ser recuperado de um instantâneo.

Por exemplo, defina o parâmetro AdditionData da VM do Azure como True para o tipo de sistema operacional 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
<!--NeedCopy-->

Recupere informações de nome de região de VMs do Azure, discos gerenciados, instantâneos, VHD do Azure e modelos ARM

Você pode exibir informações de nome de região de uma VM do Azure, discos gerenciados, instantâneos, VHD do Azure e modelos ARM. Essas informações são exibidas para recursos na imagem mestre quando um catálogo de máquinas é atribuído. Uma propriedade do PowerShell chamada RegionName exibe as informações do nome da região quando você executa o comando do PowerShell com o parâmetro AdditionalData.

Por exemplo, use o seguinte comando do PowerShell para obter informações de uma VM no Azure.

PS C:\Windows\system32> (get-item XDHyp:\HostingUnits\myAzureNetwork\image.folder\hu-dev-testing-rg.resourcegroup\hu-dev-tsvda.vm).AdditionalData
Key Value
HardDiskSizeGB 127
ResourceGroupName HU-DEV-TESTING-RG
RegionName East US
TemplateIsWindowsTemplate True
LicenseType
ServiceOfferingDescription Standard_B2ms
ServiceOfferingMemory 8192
ServiceOfferingCores 2
SupportedMachineGenerations Gen1,Gen2
ServiceOfferingWithTemporaryDiskSizeInMb 16384
SecurityType
SecureBootEnabled
VTpmEnabled
<!--NeedCopy-->

Identificar recursos criados pelo MCS

A seguir estão as tags que o MCS adiciona aos recursos na plataforma Azure. As tags na tabela são representadas como “key”:”value”.

Nome do recurso	Marca
Disco de identificação	“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 sistema operacional	“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”
Resource group	“CitrixResource” : “Internal”
	CitrixSchemaVersion: 2.0
	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
Storage account	“CitrixProvisioningSchemeId” : “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”
	“CitrixResource” : “Internal”
VM in catalog	“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 da 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.

Remover tags

Quando você cria um catálogo ou uma VM, as tags são criadas nos seguintes recursos:

Resource group
Máquina virtual
Disco do sistema operacional
Disco de identidade
Interface de rede
Storage account

Você pode remover VMs e catálogos de máquinas do banco de dados Citrix e remover tags. Você pode usar:

O parâmetro Remove-ProvVM com ForgetVM para remover VMs e tags de uma única VM ou uma lista de VMs de um catálogo de máquinas.
O parâmetro Remove-ProvScheme com ForgetVM para remover um catálogo de máquinas do banco de dados Citrix e tags de um catálogo de máquinas inteiro.

Esse recurso é aplicável somente a VMs persistentes.

Para isso:

Abra uma janela do PowerShell.
Execute asnp citrix* para carregar os módulos do PowerShell específicos à Citrix.

Execute Remove-ProvVM para excluir VMs do banco de dados Citrix e tags de VMs. Por exemplo:

Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM
<!--NeedCopy-->

Execute Remove-ProvScheme para excluir o catálogo de máquinas do banco de dados Citrix e tags dos catálogos de máquinas. Por exemplo:
```
Remove-ProvScheme -ProvisioningSchemeName “ProvisioningSchemeName” -ForgetVM

```
Nota:

Depois de usar o parâmetro ForgetVM em Remove-ProvScheme, o MCS exclui todos os instantâneos, inclusive o instantâneo do disco básico, se o esquema de provisionamento estiver presente no BYORG (traga o seu próprio grupo de recursos) ou no grupo de recursos gerenciados Citrix.

Mais informações

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Gerenciar um catálogo do Microsoft Azure

December 20, 2023

Contribuição de:

December 20, 2023

Contribuição de:

Neste artigo

Alterar o tipo de armazenamento para um nível inferior quando uma VM é desligada
Atualizar máquinas provisionadas para o estado atual do esquema de provisionamento
Atualizar propriedades de VMs individuais
Recuperar informações para VMs do Azure, instantâneos, disco de SO e definição de imagem da galeria
Recupere informações de nome de região de VMs do Azure, discos gerenciados, instantâneos, VHD do Azure e modelos ARM
Identificar recursos criados pelo MCS
Remover tags
Mais informações

Isso foi útil?

Gerenciar um catálogo do Microsoft Azure

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

Requisitos

Restrição

Alterar o tipo de armazenamento para um nível inferior

Aplicar StorageTypeAtShutdown a um catálogo existente

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

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

Atualizar propriedades de VMs individuais

Atualizar propriedades de uma VM

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

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

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

Recupere informações de nome de região de VMs do Azure, discos gerenciados, instantâneos, VHD do Azure e modelos ARM

Identificar recursos criados pelo MCS

Remover tags

Mais informações

Neste artigo

Aplicar `StorageTypeAtShutdown` a um catálogo existente