Citrix DaaS™

Gerenciar um catálogo do Microsoft Azure

May 4, 2026

Contribuição de:

C C

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

Você pode economizar custos de armazenamento alterando o tipo de armazenamento de um disco gerenciado para um nível inferior quando você desliga 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.
- Uma VM pode demorar um pouco mais para iniciar depois que você altera o tipo de armazenamento para um nível inferior.
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.
- 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 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 vezes por dia. Por exemplo, uma ação de energia pela manhã para iniciar a VM e uma à noite para desalocar a VM.

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.

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

    ```

    Exemplo de configuração de propriedades personalizadas ao criar um catálogo não persistente:

    <!--NeedCopy-->

    $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:**
>
> Ao usar 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 personalizada StorageTypeAtShutdown.
Ligue a VM. O tipo de armazenamento do disco volta para o tipo de armazenamento mencionado em:
- propriedade personalizada StorageType para disco de SO
- propriedade personalizada WBCDiskStorageType para disco WBC somente se você a especificar em CustomProperties. Caso contrário, ela volta para o tipo de armazenamento mencionado em StorageType.

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

    <!--NeedCopy-->

</CustomProperties>’

```

$ProvScheme = Get-Provscheme -ProvisioningSchemeName $CatalogName

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

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

Você pode economizar custos de armazenamento alterando o tipo de armazenamento de VMs existentes para um nível inferior quando as VMs são desligadas.

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.
1. Execute asnp citrix* para carregar os módulos PowerShell específicos da Citrix.
1. Execute Get-Provscheme -ProvisioningSchemeName $CatalogName.

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>'

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
```
1. Atualize as VMs existentes para habilitar StorageTypeAtShutdown.
```
Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -StartsNow -DurationInMinutes -1
```
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 seguinte comando para visualizar o valor de 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 } }

Para converter um catálogo de máquinas não baseado em perfil de máquina para um catálogo de máquinas baseado em perfil de máquina, conclua as seguintes etapas:

Na página “Catálogos de Máquinas”, clique com o botão direito no nome do Catálogo de Máquinas que você deseja converter e selecione “Editar Catálogo de Máquinas”.
Na página “Editar Catálogo de Máquinas” > “Perfil da Máquina”, selecione a caixa de seleção “Usar um perfil de máquina (obrigatório para Microsoft Entra ID)”.
- 1. Clique em “Selecionar um perfil de máquina”.
Na página “Selecionar um perfil de máquina”, selecione uma máquina virtual ou um modelo de inicialização para usar como perfil de máquina.
Se algumas configurações atuais diferirem das novas configurações de perfil de máquina, selecione a opção necessária para as configurações que você deseja usar e clique em “Continuar”.
Clique em “Aplicar”.

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 persistentes ou não persistentes existentes. Você também pode agendar um período para as atualizações de configuração das máquinas provisionadas pelo MCS existentes. Qualquer inicialização ou reinicialização durante o período agendado aplica uma atualização agendada 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
- Zones

Nota: - >

Você só pode atualizar as propriedades personalizadas StorageType, WBCDiskStorageType e IdentityDiskStorageType para um catálogo que usa disco gerenciado em ambientes Azure.

Se você executar Set-ProvVMUpdateTimeWindow duas vezes, o comando mais recente terá efeito.

Se uma VM for atualizada com Set-ProvVMUpdateTimeWindow e a lista atual de zonas de disponibilidade fornecida pela propriedade personalizada Zones for alterada para não incluir a zona que a VM está usando atualmente, os discos persistentes da VM serão copiados para a nova zona e os originais serão excluídos. Por exemplo, uma VM provisionada na zona 3 atualizada com a propriedade personalizada Zones definida como “1,2” moverá a VM e seus discos para a zona 1 ou 2, dependendo de qual das duas zonas tem menos máquinas para equilibrar as máquinas entre as zonas 1 e 2.

Se a propriedade personalizada Zones for completamente limpa (definida como um valor vazio), a afinidade de zona da VM será removida, permitindo que o Azure coloque a VM em qualquer zona de disponibilidade com base na capacidade. Nesse caso, os discos persistentes da VM permanecem em sua zona original e não são movidos.

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

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 do modelo como entrada de perfil de máquina:

<!--NeedCopy--> ```

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:

<!--NeedCopy--> ```

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

```

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 as atualizações para máquinas existentes sejam 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 o horário de início agendado é o horário atual.
- DurationInMinutes com um número negativo (por exemplo, –1) indica que não há limite superior para o período da agenda.

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

 Get-ProvVM -Filter \"ProvisioningSchemeUpdateAfter\" | select VMName, ProvisioningSchemeUpdateAfter

Reinicie as máquinas. Na próxima inicialização, 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 no período agendado:

Execute os seguintes comandos:
- Para agendar uma atualização com o horário de início como o horário atual:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName my-catalog -VMName vm1 -StartsNow -DurationInMinutes 120
```
Para agendar uma atualização para 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 o catálogo inteiro.
- 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.

Verifique o status da atualização.

Get-ProvVM | select VMName, ProvisioningSchemeUpdateRequested, ProvisioningSchemeUpdateUntil, ProvisioningSchemeVersion

Ligue a VM. Se você ligar a máquina após o período agendado, a atualização de 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 ligar a máquina, a atualização de configuração não será aplicada
  - você ligar a máquina, a atualização de configuração será aplicada
- Se a máquina estiver ligada e
  - você não reiniciar a máquina, a atualização de configuração não será aplicada
  - você reiniciar a máquina, a atualização de configuração será aplicada

Para cancelar a atualização de 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:

Execute Clear-ProvVMUpdateTimeWindow. Por exemplo:

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

 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName “ my-catalog “ -VMName “vm1”

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

<!--NeedCopy--> ```

 Clear-ProvVMUpdateTimeWindow -ProvisioningSchemeName "my-catalog" -VMName "vm1","vm2"

```

Nota:

As VMs devem ser do mesmo catálogo.

Você pode alterar a criptografia de disco em ambientes de virtualização do Azure e fazer o seguinte:

    -  Crie um catálogo de máquinas MCS com um conjunto de criptografia de disco (DES) diferente do DES da imagem mestre usando o comando `New-ProvScheme`. Por exemplo:

<!--NeedCopy--> ```

$customProperties = @"
    -  <CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    -  <Property xsi:type="DiskEncryptionSetId" Name="Zones" Value="/subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/testrsg/providers/Microsoft.Compute/diskEncryptionSets/test-diskEncryptionSet"/>

</CustomProperties>
”@ New-ProvScheme -CleanOnBoot ` -ProvisioningSchemeName $provisioningSchemeName ` -HostingUnitName $hostingUnitName ` -IdentityPoolName $identityPoolName ` -InitialBatchSizeHint $numberOfVms ` -masterImagePath $masterImagePath ` -NetworkMapping $networkMapping ` -CustomProperties $customProperties
```
 Altere o tipo de criptografia de disco de uma chave DES para outra chave DES de um catálogo de máquinas MCS existente e de VMs existentes usando os comandos `Set-ProvScheme` e `Set-ProvVMUpdateTimeWindow`. Após reiniciar as VMs, você poderá ver a chave DES atualizada. Por exemplo:

 
```
$customProperties = ‘

</CustomProperties>’ Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1

```

Atualize um catálogo de máquinas MCS e uma VM que não estavam previamente habilitados para CMEK para ter criptografia de chave gerenciada pelo cliente (CMEK) (DES), criptografia de disco no host ou criptografia dupla usando os comandos Set-ProvScheme e Set-ProvVMUpdateTimeWindow. Para obter informações sobre os diferentes tipos de criptografia, consulte Criptografia do lado do servidor do Azure, Criptografia de disco do Azure no host e Criptografia dupla em disco gerenciado.
Atualize um catálogo de máquinas MCS e VMs existentes para serem não criptografados, se estavam previamente criptografados, usando os comandos Set-ProvScheme e Set-ProvVMUpdateTimeWindow. Por exemplo:
```
 $customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="" />
 </CustomProperties>'
 Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
```
Habilite a criptografia de disco com ponto de extremidade privado (um catálogo de máquinas MCS que usou uma conexão de host habilitada com ProxyHypervisorTrafficThroughConnector). Para obter mais informações sobre ProxyHypervisorTrafficThroughConnector, consulte Criar um ambiente seguro para tráfego gerenciado pelo Azure. Para obter informações sobre como habilitar a criptografia de disco com pontos de extremidade privados, consulte Habilitar a criptografia de disco com ponto de extremidade privado.

De acordo com a limitação do Azure, atualmente, você não pode ter criptografia do lado do servidor com chaves gerenciadas pelo cliente para pontos de extremidade privados. No entanto, você pode atualizar um catálogo de máquinas MCS existente e VMs com pontos de extremidade privados para serem criptografados com a chave DES.

As etapas detalhadas para atualizar um catálogo de máquinas existente com pontos de extremidade privados são as seguintes:

Crie um catálogo sem criptografia de disco por meio de ProxyHypervisorTrafficThroughConnector. Para obter mais informações sobre ProxyHypervisorTrafficThroughConnector, consulte Criar um ambiente seguro para tráfego gerenciado pelo Azure.
Execute Set-ProvScheme para atualizar o catálogo com DiskEncryptionSetId.

Nota:

DiskEcryptionSetId pode ser configurado por meio de CustomProperties ou MachineProfile. Quando definido em ambos CustomProperties e MachineProfile, as propriedades definidas em CustomProperties são aplicadas.

Exemplo ao usar CustomProperties:
```
$customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1"/>
</CustomProperties>'
Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties
```
Exemplo ao usar MachineProfile: Use uma VM que tenha a criptografia de disco habilitada ou uma especificação de modelo com configurações de criptografia de disco:
```
Set-ProvScheme -ProvisioningSchemeName azure-catalog -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"
```
Alternativamente, você pode atualizar um perfil de máquina usando o Studio.
- 1. Execute Set-ProvVMUpdateTimeWindow para atualizar as VMs do catálogo existente. Por exemplo:
```
Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01, azu02 -StartsNow -DurationInMinutes -1
```
1. Após reiniciar as VMs, você poderá ver a criptografia de disco atualizada nos discos da VM no portal do Azure.
Execute Set-ProvScheme para desativar a criptografia de disco antes de adicionar novas VMs ao catálogo.

Observação:

Esta etapa é necessária porque você está atualizando um catálogo de ponto de extremidade privado. Se você não executar esta etapa, receberá erros ao tentar adicionar novas VMs ao catálogo.

Por exemplo:

<!--NeedCopy--> ```

$customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="" />
</CustomProperties>'
Set-ProvScheme -ProvisioningSchemeName azure-catalog -CustomProperties $customProperties

```

Adicione novas VMs ao catálogo.

As etapas detalhadas para atualizar VMs de catálogo individuais são as seguintes:

Crie um catálogo sem criptografia de disco por meio de ProxyHypervisorTrafficThroughConnector. Para obter mais informações sobre ProxyHypervisorTrafficThroughConnector, consulte Criar um ambiente seguro para tráfego gerenciado pelo Azure.

Execute Set-ProvVM para atualizar a VM do catálogo com DiskEncryptionSetId.

Observação:

O DiskEcryptionSetId pode ser configurado por meio de CustomProperties ou MachineProfile.

Exemplo ao usar CustomProperties:

$customProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Property xsi:type="StringProperty" Name="DiskEncryptionSetId" Value="/subscriptions/456c683e2ed7/resourceGroups/testrg/providers/Microsoft.Compute/diskEncryptionSets/diskEncryptionSet1" />
</CustomProperties>'
Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -CustomProperties $customProperties

Exemplo ao usar MachineProfile:

Set-ProvVM -ProvisioningSchemeName azure-catalog  -VMName azu01 -MachineProfile "XDHyp:\HostingUnits\azureunit\machineprofile.folder\testrg.resourcegroup\new-template.vm"

Execute Set-ProvVMUpdateTimeWindow para atualizar as VMs de catálogo existentes. Por exemplo:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName azure-catalog -VMName azu01 -StartsNow -DurationInMinutes -1

Depois de reiniciar as VMs, você poderá ver a criptografia de disco atualizada nos discos das VMs no portal do Azure.

1. Adicione novas VMs ao catálogo.

Você pode usar o disco temporário do Azure como disco de cache de gravação (WBC) para catálogos de máquinas MCS existentes. Use o comando PowerShell Set-ProvScheme para atualizar catálogos e VMs existentes.

O catálogo existente deve satisfazer as seguintes condições:

Observação:

Se o catálogo existente não atender aos seguintes requisitos, o disco WBC não será colocado dentro do disco temporário.

MCSIO está habilitado: As propriedades personalizadas WriteBackCacheMemorySize, WriteBackCacheDiskSize e UseWriteBackCache estão habilitadas.
O disco do SO efêmero não está habilitado.
O WBC não é persistente: PersistWBC é false.
UseTempDiskForWBC é nulo ou falso.
O tamanho do disco temporário deve ser maior que o tamanho total de (tamanho do disco de cache de gravação + espaço reservado para arquivo de paginação + 1 GB de espaço de buffer).
Importante:
- Não é permitido alterar uma oferta de serviço de uma com disco temporário para uma sem, ou o inverso.

Para atualizar um catálogo existente, execute os seguintes comandos:

Execute Set-ProvScheme no catálogo existente para atualizar UseTempDiskForWBC para true. Por exemplo:

Set-ProvScheme -ProvisioningSchemeName name -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=`"Standard_LRS`"/><Property xsi:type=`"StringProperty`" Name=`"UseManagedDisks`" Value=`"True`"/><Property xsi:type=`"StringProperty`" Name=`"ManagedDisksPreview`" Value=`"False`"/><Property xsi:type=`"StringProperty`" Name=`"PersistOsDisk`" Value=`"False`"/><Property xsi:type=`"StringProperty`" Name=`"UseTempDiskForWBC`" Value=`"True`"/><Property xsi:type=`"StringProperty`" Name=`"PersistWBC`" Value=`"False`"/></CustomProperties>"

Adicione novas máquinas ao catálogo e ligue-as. As novas VMs terão um disco WBC dentro do disco temporário.

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 esta funcionalidade para visualizar e selecionar uma imagem Linux ou Windows. Uma propriedade 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 e 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 instantâneo de um disco de dados não contém o campo TemplateIsWindowsTemplate porque o tipo de SO 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 SO Windows usando 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

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

Por exemplo, use o seguinte comando 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

Divida um catálogo MCS persistente e não persistente existente em vários catálogos. Ao criar um clone do esquema de provisionamento original, você pode aplicar diferentes políticas e configurações em nível de catálogo a subconjuntos específicos de VMs. Essa funcionalidade é particularmente útil quando diferentes funções dentro de uma organização, como Finanças ou Executivos, exigem configurações de recursos diferentes (por exemplo, limites de backup) em comparação com usuários padrão.

Um administrador gerencia um grande catálogo de VMs. A equipe Executiva exige um número maior de backups do que o permitido pela política padrão. O administrador usa o comando Copy-ProvScheme para clonar o esquema de provisionamento do catálogo existente em um novo catálogo. Isso permite que o administrador aplique uma política de backup dedicada ao novo catálogo Executivo, mantendo as configurações originais para o restante da organização.

Ambientes Azure
Catálogos MCS persistentes e não persistentes
Catálogos Citrix Provisioning provisionados por MCS
Esquema de provisionamento: Somente a versão mais recente do esquema de provisionamento é copiada.
Agendamentos de backup: O agendamento de backup não é copiado para o novo catálogo; o novo catálogo deve ter seu próprio agendamento de backup configurado.
Pools de identidade: Objetos relacionados à identidade não são clonados e permanecem compartilhados usando o mesmo ADAccountIdentityPool.
Grupos de entrega: As operações de grupo de entrega e as atribuições de usuário não são alteradas ou associadas durante o processo de clonagem.
Grupos de Recursos (TargetLocation):
- Se você não fornecer um TargetLocation (Grupo de Recursos do Azure):
  - Para um grupo de recursos gerenciado pela Citrix, um novo grupo de recursos gerenciado pela Citrix é criado.
  - Para um grupo de recursos BYO (Bring Your Own), os novos recursos do esquema de provisionamento são criados no mesmo grupo de recursos.
- Se você fornecer um TargetLocation:
  - Os recursos são criados no grupo de recursos fornecido.
  - O grupo de recursos especificado já deve existir no Azure.
Instantâneo do Disco Base: Uma cópia do instantâneo do disco base é sempre feita, independentemente da configuração do grupo de recursos.
Um esquema de provisionamento existente (catálogo de origem) deve estar disponível.
Se você especificar um local de destino, o Grupo de Recursos do Azure de destino deve existir.

Abra uma janela do PowerShell.
Execute o comando Copy-ProvScheme usando os parâmetros necessários: SourceProvisioningSchemeName (ou SourceProvisioningSchemeUid) e TargetProvisioningSchemeName.

Exemplo 1: Copiar um esquema de provisionamento por nome.

Este exemplo copia o esquema chamado “Backup” para um novo esquema chamado “TestCopy”.
```
Copy-ProvScheme -SourceProvisioningSchemeName Backup -TargetProvisioningSchemeName TestCopy
```
Exemplo 2: Copiar um esquema de provisionamento por Uid para um Grupo de Recursos específico

Este exemplo copia um esquema usando seu Uid e especifica um grupo de recursos de destino chamado “TestRg”.
```
Copy-ProvScheme -SourceProvisioningSchemeUid 771e205d-1ee5-4ad2-b044-ecf3d7f24ec7 -TargetProvisioningSchemeName TestCopy -TargetLocation TestRg
```

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

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”
VM de Preparação	“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”

Observação:

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.

Ao criar um catálogo ou uma VM, as tags são criadas nos seguintes recursos:

Grupo de recursos
Máquina virtual
Disco do SO
Disco de identidade
Interface de rede
Conta de armazenamento

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

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

Este recurso é aplicável apenas a VMs persistentes.

Para fazer isso:

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

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

Remove-ProvVM -ProvisioningSchemeName “ProvisioningSchemeName” -VMName “vmname” -ForgetVM

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

Depois de usar o parâmetro ForgetVM em Remove-ProvScheme, o MCS exclui todos os instantâneos, incluindo o instantâneo do disco base, se o esquema de provisionamento estiver presente em um grupo de recursos próprio (BYORG) ou em um grupo de recursos gerenciado pela Citrix.

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

May 4, 2026

Contribuição de:

C C

May 4, 2026

Contribuição de:

C C

Neste artigo

Isso foi útil?