Gerenciar catálogos de máquinas de imagem preparados
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:
- Estúdio
- 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 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 do mouse e selecione Alterar imagem preparada.
-
No Imagem , selecione uma imagem preparada.
Observação:
Aplicável ao Azure: você também pode escolher uma imagem com ACG não habilitado e depois selecionar Colocar a imagem preparada na Galeria de Computação do Azure para colocar as imagens na galeria.
- No Estratégia de distribuição , selecione quando deseja atualizar este catálogo com a imagem preparada selecionada.
- No Resumo , verifique os detalhes. Clique Acabar.
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:
- Selecione um catálogo de máquinas.
- Sob o Propriedades do modelo na guia Imagem preparada , clique em Ver histórico de imagens.
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 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 da imagem para especificar a finalidade dessa versão da imagem.
Para editar uma versão de imagem, faça o seguinte:
- Vá para o Imagens , selecione uma versão da imagem e selecione Editar descrição.
Excluir uma versão da imagem
Para excluir uma versão da imagem, faça o seguinte:
- Vá para o Imagens , selecione uma versão da imagem e selecione Excluir versão da imagem.
Observação:
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:
- Vá para o Imagens , selecione uma definição de imagem e selecione Excluir definição de imagem.
Observação:
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 Set-ProvSchemeImage comando. Por exemplo,
Set-ProvSchemeImage -ProvisioningSchemeUid <Guid> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
Ou,
Set-ProvSchemeImage -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> [-DoNotStoreOldImage] [-RunAsynchronously] [-PurgeJobOnSuccess]
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
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, uma versão de imagem e uma especificação de versão de imagem preparada:
- Uma definição de imagem não poderá ser excluída se contiver qualquer versão de imagem.
- Uma versão de imagem não poderá ser excluída se contiver qualquer especificação de versão de imagem.
- Uma especificação de versão de imagem mestre não poderá 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 poderá ser excluída se for usada por qualquer catálogo de máquinas do 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 da máquina. Por exemplo,
Remove-ProvScheme -ProvisioningScheneName decouplingCatalog -
Remova a especificação da versão da imagem preparada compartilhada. Por exemplo,
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <uid> -HostingUnitName AzureWest -
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 -
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 -RunAsynchronouslObservação:
A especificação de versão da imagem mestre só pode ser excluída quando não houver nenhuma especificação de versão de imagem preparada associada.
-
Remova uma versão da imagem. Por exemplo,
Remove-ProvImageVersion -ImageDefinitionName image1 -ImageVersionNumber 1 -
Remova a configuração para definição de imagem na conexão de hospedagem especificada. Por exemplo,
Remove-ProvImageDefinitionConnection -ImageDefinitionName xx -HypervisorConnectionName xxx -
Remova uma definição de imagem. Por exemplo,
Remove-ProvImageDefinition -ImageDefinitionName image1
Exemplo do conjunto completo de comandos do PowerShell quando a imagem preparada não é compartilhada entre a unidade 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
Exemplo do conjunto completo de comandos do PowerShell quando a imagem preparada é compartilhada entre a unidade 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
Gerenciar a definição e a versão da 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
Renomear-ProvImageDefinitioncomando. Por exemplo:Rename-ProvImageDefinition -ImageDefinitionUid <Guid> -NewImageDefinitionName <string>Ou,
Rename-ProvImageDefinition -ImageDefinitionName <string> -NewImageDefinitionName <string> -
Edite uma definição de imagem usando o
Set-ProvImageDefinitioncomando. Por exemplo:Set-ProvImageDefinition -ImageDefinitionUid <Guid> [-Description <string>]Ou,
Set-ProvImageDefinition -ImageDefinitionName <string> [-Description <string>] -
Edite uma versão da imagem usando o
Set-ProvImageVersioncomando. Por exemplo:Set-ProvImageVersion -ImageVersionUid <Guid> [-Description <string>]Ou,
Set-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int> [-Description <string>]
Obter definição de imagem, versão da imagem, especificação de versão de imagem preparada e detalhes do esquema de provisionamento
-
Obtenha detalhes de definição de imagem usando o comando
Get-ProvImageDefinitioncomando. Por exemplo:Get-ProvImageDefinition [-ImageDefinitionName <string>] [-ImageDefinitionUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <int>] [-Skip <int>] [-SortBy <string>] [-Filter <string>] -
Obtenha detalhes da versão da imagem usando o
Get-ProvImageVersioncomando. Por exemplo:-
Para listar versões de imagem em uma definição de imagem,
Get-ProvImageVersion -ImageDefinitionUid <Guid>Ou,
Get-ProvImageVersion -ImageDefinitionName <string> -
Para obter um detalhe da versão da imagem,
Get-ProvImageVersion -ImageVersionUid <Guid>Ou,
Get-ProvImageVersion -ImageDefinitionName <string> -ImageVersionNumber <int>
-
-
Obtenha especificações de versão de imagem preparadas usando o
Get-ProvImageVersionSpeccomando. Por exemplo:-
Para listar todas as especificações de versão de imagem preparadas em uma versão de imagem,
Get-ProvImageVersionSpec -ImageVersionUid <Guid> -
Para listar as especificações de versão da imagem mestre em uma especificação de versão de imagem preparada,
Get-ProvImageVersionSpec -ImageVersionUid <Guid> -Filter 'PreparationType -eq "None"' -
Para listar as especificações de versão de imagem preparadas 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"' -
Para obter especificações de versão de imagem preparadas com êxito 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"' -
Para obter um detalhe de especificação de versão de imagem preparada,
Get-ProvImageVersionSpec -ImageVersionSpecUid <Guid>
-
-
Obtenha detalhes do esquema de provisionamento usando o
Get-ProvSchemecomando. Por exemplo:Get-ProvScheme [[-ProvisioningSchemeName] <String>] [-ProvisioningSchemeUid <Guid>] [-ScopeId <Guid>] [-ScopeName <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>] -
Obtenha o histórico de especificações de versão da imagem preparada de um esquema de provisionamento usando o
Get-ProvSchemeImageVersionSpecHistorycomando. Por exemplo:Get-ProvSchemeImageVersionSpecHistory [-ProvisioningSchemeName <String>] [-ProvisioningSchemeUid <Guid>] [-ImageVersionSpecUid <Guid>] [-ImageVersionSpecHistoryUid <Guid>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-FilterScope <Guid>]