Treinamento
Módulo
Examinar o módulo do Azure PowerShell - Training
Este módulo explica o ambiente do Azure PowerShell e o módulo Az para Windows PowerShell. Ele também explica como gerenciar a ID do Microsoft Entra usando módulos do PowerShell.
Não há mais suporte para esse navegador.
Atualize o Microsoft Edge para aproveitar os recursos, o suporte técnico e as atualizações de segurança mais recentes.
Estamos avançando com o uso da nova versão da ferramenta de geração de código, AutoRest.PowerShell v4, para aproveitar os recursos oferecidos pela versão mais recente. A reformulação do código gerado para dar suporte a novos requisitos de usuário nesta versão inevitavelmente apresenta algumas alterações significativas.
Abaixo, listamos as possíveis alterações significativas da perspectiva dos usuários que podem ocorrer ao atualizar a ferramenta de geração de código para módulos do Azure PowerShell.
Observação
As alterações interruptivas listadas abaixo podem não se aplicar universalmente a todos os módulos gerados. A ocorrência dessas alterações interruptivas também depende das configurações específicas usadas ao gerar módulos do Azure PowerShell com o AutoRest.PowerShell v4. Para obter informações detalhadas sobre quais alterações interruptivas podem ocorrer, consulte o para o módulo específico.
Agora geramos propriedades semelhantes a coleções como List
em vez de Array
nos modelos. Isso ocorre porque List
é dinâmico que permite acrescentar/excluir elementos, enquanto Array
é de tamanho fixo, portanto, é difícil de editar.
Usamos para gerar um struct para enum para dar suporte ao preenchimento de guia para parâmetros. Esse design foi abandonado devido à limitação de dar suporte apenas a enumes com tipo de cadeia de caracteres.
Geralmente, essa alteração não causará uma alteração significativa para os usuários. Em módulos gerados por versões mais antigas, os usuários normalmente usam tipos primitivos e o struct gerado inclui um conversor que transforma esses tipos primitivos no struct. O único requisito para os usuários é evitar o uso Microsoft.Azure.PowerShell.Cmdlets.{module}.Support
diretamente.
PassThru é um parâmetro de alternância que adicionamos aos cmdlets que não têm saídas para habilitar a funcionalidade do pipeline. No AutoRest.PowerShell v3, PassThru foi adicionado incorretamente a alguns cmdlets que têm saídas. Isso é corrigido na v4 e os parâmetros PassThru
Descontinue o uso do parâmetro PassThru para esses cmdlets. Tenha cuidado, pois, ao fazer isso, a saída pode mudar.
Se uma propriedade estiver marcada "x-ms-mutability": ["read"]
na especificação OpenAPI, isso significa que ela só deverá aparecer na saída, mas nunca como um parâmetro de entrada. No entanto, no AutoRest.PowerShell v3, esse tipo de parâmetros readonly foram gerados incorretamente para cmdlets.
É seguro simplesmente remover esses parâmetros readonly, pois eles são ignorados pelo serviço.
Treinamento
Módulo
Examinar o módulo do Azure PowerShell - Training
Este módulo explica o ambiente do Azure PowerShell e o módulo Az para Windows PowerShell. Ele também explica como gerenciar a ID do Microsoft Entra usando módulos do PowerShell.