Gerenciar catálogos de máquinas de imagem preparada

Você pode atualizar um catálogo de máquinas MCS existente com uma imagem preparada diferente e gerenciar as definições e versões da imagem usando:

• Web Studio
• PowerShell

Usar o Web Studio

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

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

1. Clique em Catálogos de Máquinas no painel de navegação esquerdo e selecione um catálogo de máquinas que você deseja atualizar. Clique com o botão direito e selecione Alterar Imagem Preparada.

2. Na página Imagem, selecione uma imagem preparada. Se necessário, adicione uma nota para a imagem preparada selecionada.

   Nota:

   Aplicável ao Azure: Você também pode escolher uma imagem com ACG não habilitado e, posteriormente, selecionar a caixa de seleção Colocar imagem preparada na Galeria de Computação do Azure para colocar as imagens na galeria.

3. Para reverter para uma imagem preparada atribuída anteriormente, clique em Usar atribuição de imagem anterior para reversão rápida na parte inferior do assistente.

   Uma nova janela é aberta e exibe uma lista de todas as atribuições de imagem históricas disponíveis. Ao selecionar uma imagem da lista, a versão correspondente é selecionada automaticamente na árvore de imagens preparadas na página da imagem.

4. Na página Estratégia de implantação, selecione quando você deseja atualizar este catálogo com a imagem preparada selecionada.
5. Na página Resumo, verifique os detalhes. Clique em Concluir.

Você pode ver o histórico de alterações de imagem feitas em um catálogo. Para ver o histórico, faça o seguinte:

1. Selecione um catálogo de máquinas.
2. Na guia Propriedades do Modelo, no campo Imagem preparada, clique em Exibir histórico da imagem.

Gerenciar as definições e versões de imagem

Você pode editar e excluir as definições e versões de imagem para gerenciar o uso de várias versões e definições de imagem criadas.

Editar uma definição de imagem

Você pode editar o nome e a descrição de uma definição de imagem.

Para editar uma definição de imagem, faça o seguinte:

1. Vá para o nó Imagens, selecione uma definição de imagem e selecione Editar Definição de Imagem.

Editar versão da imagem

Você pode editar a descrição de uma versão de imagem para especificar a finalidade dessa versão de imagem.

Para editar uma versão de imagem, faça o seguinte:

1. Vá para o nó Imagens, selecione uma versão de imagem e selecione Editar Descrição.

Excluir uma versão de imagem

Para excluir uma versão de imagem, faça o seguinte:

1. Vá para o nó Imagens, selecione uma versão da imagem e selecione Excluir Versão da Imagem.

Nota:

Não é possível excluir uma versão da imagem se ela estiver sendo usada por um catálogo de máquinas.

Excluir uma definição de imagem

Para excluir uma definição de imagem, faça o seguinte:

1. Vá para o nó Imagens, selecione uma definição de imagem e selecione Excluir Definição de Imagem.

Nota:

Não é possível excluir uma definição de imagem se ela contiver uma versão da imagem.

Usar o PowerShell

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

Você pode atualizar um catálogo usando o comando Set-ProvSchemeImage. Por exemplo,

Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Ou,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess][-ImageAssignmentNote <string>]
<!--NeedCopy-->

Exemplo do conjunto completo de comandos do PowerShell para atualizar um catálogo:

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 2 -Filter "PreparationType -eq 'Mcs'"

Set-ProvSchemeImage -ProvisioningSchemeName azurecatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously -ImageAssignmentNote "Update from VST team"
<!--NeedCopy-->

Obter o histórico de alterações da imagem para o esquema de provisionamento

Get-ProvSchemeImageVersionSpecHistory -ProvisioningSchemeName azurecatalog
<!--NeedCopy-->

Excluir definição de imagem, versão da imagem e especificação de versão de imagem preparada

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

• Uma definição de imagem não pode ser excluída se contiver qualquer versão de imagem.
• Uma versão de imagem não pode ser excluída se contiver qualquer especificação de versão de imagem.
• Uma especificação de versão de imagem mestre não pode ser excluída se for usada por qualquer outra especificação de versão de imagem preparada.
• Uma especificação de versão de imagem preparada não pode ser excluída se for usada por qualquer catálogo de máquinas MCS.
• Uma unidade de hospedagem não pode ser excluída se for usada por qualquer outra especificação de versão de imagem preparada.

As etapas detalhadas são as seguintes:

1. Remova o catálogo de máquinas. Por exemplo,

   Remove-ProvScheme -ProvisioningScheneName decouplingCatalog
   <!--NeedCopy-->
   

2. Remova a especificação de versão de imagem preparada compartilhada. Por exemplo,

   Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest
   <!--NeedCopy-->
   

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

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

4. Remova a especificação de versão de imagem mestre. Por exemplo,

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

   Nota:

   A especificação de versão de imagem mestre só pode ser excluída quando não houver nenhuma especificação de versão de imagem preparada associada.

5. Remova uma versão de imagem. Por exemplo,

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

6. Remova a configuração para definição de imagem na conexão de hospedagem especificada. Por exemplo,

   Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx
   <!--NeedCopy-->
   

7. Remover uma definição de imagem. Por exemplo,

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

Exemplo do conjunto completo de comandos PowerShell quando a imagem preparada não é compartilhada entre unidades de host:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

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

Exemplo do conjunto completo de comandos PowerShell quando a imagem preparada é compartilhada entre unidades de host:

Remove-ProvScheme -ProvisioningSchemeName decouplingCatalog

Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid>
-HostingUnitName AzureWest

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

$MasterImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'None'"

Remove-ProvImageVersionSpec -ImageVersionSpecUid $MasterImageVersionSpec.ImageVersionSpecUid -RunAsynchronously

Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1

Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx

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

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

Você pode renomear e editar uma definição de imagem, e editar uma versão de imagem.

• Renomeie uma definição de imagem usando o comando Rename-ProvImageDefinition. Por exemplo:

   Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>
   <!--NeedCopy-->
  

  Ou,

   Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string>
   <!--NeedCopy-->
  

• Edite uma definição de imagem usando o comando Set-ProvImageDefinition. Por exemplo:

   Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]
   <!--NeedCopy-->
  

  Ou,

   Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>]
   <!--NeedCopy-->
  

• Edite uma versão de imagem usando o comando Set-ProvImageVersion. Por exemplo:

   Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]
   <!--NeedCopy-->
  

  Ou,

   Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
   <!--NeedCopy-->
  

Obter detalhes da definição de imagem, versão da imagem, especificação da versão da imagem preparada e esquema de provisionamento

• Obtenha detalhes da definição de imagem usando o comando Get-ProvImageDefinition. Por exemplo:

   Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>]
   <!--NeedCopy-->
  

• Obtenha detalhes da versão da imagem usando o comando Get-ProvImageVersion. Por exemplo:

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

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

    Ou,

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

  • Para obter detalhes de uma versão de imagem,

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

    Ou,

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

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

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

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

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

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

  • Para listar as especificações da versão da imagem preparada em uma versão de imagem, que está associada a uma imagem mestre,

     Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"'
     <!--NeedCopy-->
    

  • Para obter especificações de versão de imagem preparada bem-sucedidas em uma versão de imagem,

     Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "MCS" -and SourceImageVersionSpecUid -eq "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -and ImageVersionSpecStatus -eq "Complete"'
     <!--NeedCopy-->
    

  • Para obter detalhes de uma especificação de versão de imagem preparada,

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

• Obtenha os detalhes do esquema de provisionamento usando o comando Get-ProvScheme. Por exemplo:

   Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
   <!--NeedCopy-->
  

• Obtenha o histórico da especificação da versão da imagem preparada de um esquema de provisionamento usando o comando Get-ProvSchemeImageVersionSpecHistory. Por exemplo:

   Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]
   <!--NeedCopy-->
  

Mais informações

• Gerenciamento de imagens