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.

   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. Na página Estratégia de implantação, selecione quando você deseja atualizar este catálogo com a imagem preparada selecionada.
4. 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 de imagem e selecione Excluir Versão da Imagem.

Nota:

Você não pode excluir uma versão de imagem se ela for 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:

Você não pode excluir uma definição de imagem se ela contiver uma versão de imagem.

Usar 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]
<!--NeedCopy-->

Ou,

Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
<!--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
<!--NeedCopy-->

Excluir definição de imagem, versão de 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 da versão da 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 da versão da imagem mestre só pode ser excluída quando não houver nenhuma especificação da versão da 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 a definição da imagem na conexão de hospedagem especificada. Por exemplo,

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

7. Remova 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 de 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 um detalhe da versão da 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 da 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 um detalhe da especificação da versão da 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