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 de imagem usando:
- Studio
- PowerShell
Usar o 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:
- Clique em “Catálogos de Máquinas” no painel esquerdo e selecione um catálogo de máquinas que você deseja atualizar. Clique com o botão direito do mouse e selecione “Alterar Imagem Preparada”.
-
Na página “Imagem”, selecione uma imagem preparada. Se necessário, adicione uma nota para a imagem preparada selecionada.
Nota:
(Somente 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.
-
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 de imagem.
- Na página “Estratégia de implantação”, selecione quando você deseja atualizar este catálogo com a imagem preparada selecionada.
- Na página “Resumo”, verifique os detalhes. Clique em “Concluir”.
Para visualizar o histórico de alterações de imagem feitas em um catálogo, siga estas etapas:
- Selecione um catálogo de máquinas.
- 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:
- Vá para o nó “Imagens”, selecione uma definição de imagem e selecione “Editar Definição de Imagem”.
Editar versão de 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:
- 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:
- Vá para o nó “Imagens”, selecione uma versão de imagem e selecione “Excluir Versão de Imagem”.
Nota:
Você não pode excluir uma versão de 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:
- 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 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 de imagem para o esquema de provisionamento
Get-ProvSchemeImageVersionSpecHistory -ProvisioningSchemeName azurecatalog
<!--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:
-
Remova o catálogo de máquinas. Por exemplo,
Remove-ProvScheme -ProvisioningScheneName decouplingCatalog <!--NeedCopy-->
-
Remova a especificação de versão de imagem preparada compartilhada. Por exemplo,
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest <!--NeedCopy-->
-
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-->
-
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 há nenhuma especificação de versão de imagem preparada associada.
-
Remova uma versão de imagem. Por exemplo,
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1 <!--NeedCopy-->
-
Remova a configuração para a definição de imagem na conexão de hospedagem especificada. Por exemplo,
Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx <!--NeedCopy-->
-
Remova uma definição de imagem. Por exemplo,
Remove-ProvImageDefinition -ImageDefinitionName image1 <!--NeedCopy-->
Exemplo do conjunto completo de comandos do 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 do 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 de versão de 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 de imagem usando o comando
Get-ProvImageVersion
. Por exemplo:-
Para listar 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 de imagem,
Get-ProvImageVersion -ImageVersionUid <Guid> <!--NeedCopy-->
Ou,
Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> <!--NeedCopy-->
-
-
Obtenha a especificação de versão de 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 de versão de imagem mestre em uma especificação de versão de imagem preparada,
Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"' <!--NeedCopy-->
-
Para listar as especificações de versão de 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 um detalhe da especificação de versão de imagem preparada,
Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid> <!--NeedCopy-->
-
-
Obtenha 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 de versão de 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-->