Registra um tipo de aplicativo do Service Fabric.
\n","uid":"ServiceFabric.Register-ServiceFabricApplicationType"}]},"_xrefmap":{"ServiceFabric":{"href":"./","monikerGroup":"211ed502c73b0cca8ae5b56c0993186a","name":"ServiceFabric","schemaType":"PowershellModule","uid":"ServiceFabric"},"ServiceFabric.Register-ServiceFabricApplicationType":{"href":"register-servicefabricapplicationtype","monikerGroup":"211ed502c73b0cca8ae5b56c0993186a","name":"Register-ServiceFabricApplicationType","schemaType":"PowershellCmdlet","summary":"Registra um tipo de aplicativo do Service Fabric.
\n","uid":"ServiceFabric.Register-ServiceFabricApplicationType"}},"description":"O cmdlet
O pacote de aplicativos pode existir em um local relativo no repositório de imagens ou pode ser um arquivo sfpkg carregado anteriormente em um local externo.
Ao usar o caminho relativo do repositório, o pacote de aplicativos deve existir no repositório de imagens. O pacote pode ser copiado para o repositório de imagens com Copy-ServiceFabricApplicationPackage.
\nAo usar um arquivo sfpkg de um repositório externo, o provisionamento deve fornecer o URI de download para onde o sfpkg foi carregado anteriormente, bem como as informações de tipo de aplicativo.\nO arquivo sfpkg é um zip que contém o pacote inicial do aplicativo e tem a extensão \".sfpkg\".\nDentro do zip, o pacote do aplicativo pode ser compactado ou descompactado. A compactação do pacote de aplicativos dentro do zip é feita em pacotes de código, pacote e dados.
Para criar um sfpkg, comece com uma pasta que contenha o pacote de aplicativo original. Se necessário, compacte o pacote com Copy-ServiceFabricApplicationPackage com comutadores -CompressPackage e -SkipCopy.\nEm seguida, use um utilitário para fechar a pasta com a extensão \".sfpkg\". Por exemplo, use ZipFile.CreateFromDirectory na pasta do pacote de aplicativos.
Depois de registrar um tipo de aplicativo, você pode usar o cmdlet New-ServiceFabricApplication para criar uma instância do aplicativo. Use o cmdlet Start-ServiceFabricApplicationUpgrade para atualizar um aplicativo existente.
\nQuando o tipo de aplicativo com a versão especificada não for mais necessário, você poderá cancelá-lo usando cmdlet Unregister-ServiceFabricApplicationType.
\nPara gerenciar clusters do Service Fabric, inicie o Windows PowerShell usando a opção Executar como administrador.\nAntes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster.
\n","examples":[{"code":"PS C:\\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath \"c:\\work\\PersistentToDoListService\" -ImageStoreConnectionString \"file:C:\\SfDevCluster\\Data\\ImageStoreShare\" -ApplicationPackagePathInImageStore \"PersistentToDoListService\"\nPS C:\\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore \"PersistentToDoListService\"","description":"\n Copy-ServiceFabricApplicationPackage copia o pacote de aplicativos encontrado na pasta \"c:\\work\\PersistentToDoListService\" para o repositório de imagens. O pacote é copiado no caminho relativo \"PersistentToDoListService\" no repositório de imagens.
\n\n comando Register-ServiceFabricApplicationType registra o tipo de aplicativo encontrado no caminho relativo \"PersistentToDoListService\".
\n","summary":"","title":"Exemplo 1: registrar um tipo de aplicativo com o caminho relativo do repositório de imagens"},{"code":"PS C:\\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath \"c:\\work\\PersistentToDoListService\" -ImageStoreConnectionString \"fabric:ImageStore\" -ApplicationPackagePathInImageStore \"PersistentToDoListService\" -CompressPackage\nPS C:\\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore \"PersistentToDoListService\" -Async\nPS C:\\> Get-ServiceFabricApplicationType","description":"\n Copy-ServiceFabricApplicationPackage copia o pacote de aplicativos encontrado na pasta \"c:\\work\\PersistentToDoListService\" para o repositório de imagens. O pacote do aplicativo é copiado no caminho relativo \"PersistentToDoListService\" no repositório de imagens. O cmdlet usa compactação para reduzir o tamanho do pacote.
\n\n comando Register-ServiceFabricApplicationType registra o tipo de aplicativo encontrado no caminho relativo \"PersistentToDoListService\". O registro é feito de forma assíncrona e retorna assim que o comando é aceito pelo cluster.
\n\n Get-ServiceFabricApplicationType obtém os tipos de aplicativo registrados no cluster. Cada tipo de aplicativo inclui o status de registro. O cmdlet pode ser usado para determinar quando o registro é concluído.
\n","summary":"","title":"Exemplo 2: registrar um tipo de aplicativo com o caminho relativo do repositório de imagens assíncrono"},{"code":"PS C:\\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath \"c:\\work\\PersistentToDoListService\" -ImageStoreConnectionString \"fabric:ImageStore\" -ApplicationPackagePathInImageStore \"PersistentToDoListService\" -CompressPackage -TimeoutSec 2700\nPS C:\\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore \"PersistentToDoListService\" -TimeoutSec 2700","description":"\n Copy-ServiceFabricApplicationPackage copia o pacote de aplicativos encontrado na pasta \"c:\\work\\PersistentToDoListService\" para o repositório de imagens, no local relativo do repositório de imagens \"PersistentToDoListService\". Como o pacote inicial é muito grande, o comando compacta-o e inclui um tempo limite maior para permitir tempo suficiente para cópia.
\n\n comando Register-ServiceFabricApplicationType registra o tipo de aplicativo encontrado no caminho relativo \"PersistentToDoListService\". O comando inclui um tempo limite maior para permitir que o trabalho seja concluído mesmo se o pacote de aplicativos for grande.
\n","summary":"","title":"Exemplo 3: registrar um tipo de aplicativo para um pacote de aplicativo grande com o caminho relativo do repositório de imagens"},{"code":"PS C:\\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri \"https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg\" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -TimeoutSec 2700","description":"Registra o pacote de aplicativos encontrado no URI especificado. O pacote do aplicativo deve ter sido carregado anteriormente nesse local e deve permitir o acesso DE LEITURA.\nComo o pacote pode ser grande, o comando especifica um tempo limite de provisionamento grande.
\n","summary":"","title":"Exemplo 4: registrar um tipo de aplicativo de um repositório externo"},{"code":"PS C:\\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri \"https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg\" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -Async\nPS C:\\> Get-ServiceFabricApplicationType -ApplicationTypeName MyApp -ApplicationTypeVersion V1","description":"Registra o pacote de aplicativos encontrado no URI especificado. O pacote do aplicativo deve ter sido carregado anteriormente nesse local e deve permitir o acesso DE LEITURA.\nComo -Async é especificado, o comando retorna assim que o cluster o aceita.\n\n Get-ServiceFabricApplicationType obtém os tipos de aplicativo registrados no cluster que correspondem ao filtro. Cada tipo de aplicativo inclui o status de registro. O cmdlet pode ser usado para acompanhar o progresso do registro e determinar quando o registro é concluído.
\n","summary":"","title":"Exemplo 5: registrar um tipo de aplicativo de um repositório externo assíncrono"},{"code":"PS C:\\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath \"c:\\work\\PersistentToDoListService\"\n\nPS C:\\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore \"PersistentToDoListService\" -ApplicationPackageCleanupPolicy Automatic\n\n[Copy-ServiceFabricApplicationPackage](./Copy-ServiceFabricApplicationPackage.yml) copies the application package found in the \"c:\\work\\PersistentToDoListService\" folder to the image store. The package is copied at the relative path \"PersistentToDoListService\" in image store.\n\n[Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command registers the application type found in the relative path \"PersistentToDoListService\" and deletes the application package \"PersistentToDoListService\" in the image store after successfully registering the application type. Deleting the application package from the image store after [Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command is recommended because it removes the temporary package as soon as it's not needed, which ensures that disk space is not consumed unnecessarily.","description":"","summary":"","title":"Exemplo 6: registrar um tipo de aplicativo com o caminho relativo do repositório de imagens e a limpeza automática do pacote"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"connect-servicefabriccluster","text":"Connect-ServiceFabricCluster"},{"href":"copy-servicefabricapplicationpackage","text":"Copy-ServiceFabricApplicationPackage"},{"href":"get-servicefabricclusterconnection","text":"Get-ServiceFabricClusterConnection"},{"href":"get-servicefabricapplicationtype","text":"Get-ServiceFabricApplicationType"},{"href":"unregister-servicefabricapplicationtype","text":"Unregister-ServiceFabricApplicationType"},{"href":"new-servicefabricapplication","text":"New-ServiceFabricApplication"},{"href":"start-servicefabricapplicationupgrade","text":"Start-ServiceFabricApplicationUpgrade"},{"href":"remove-servicefabricapplicationpackage","text":"Remove-ServiceFabricApplicationPackage"}],"module":"ServiceFabric","name":"Register-ServiceFabricApplicationType","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"Default","description":"Determina a política de limpeza do pacote de aplicativos usado para registrar o tipo de aplicativo. Se não estiverem limpos, os pacotes de aplicativos consumirão espaço em disco e poderão causar falhas. Esse parâmetro especifica como gerenciar o pacote de aplicativos depois de registrar com êxito o tipo de aplicativo (provisionamento bem-sucedido).
\nQuando definido como Automatic, o runtime do Service Fabric determina quando executar a limpeza do pacote do aplicativo. A implementação atual do runtime exclui o pacote do aplicativo depois de registrar com êxito o tipo de aplicativo. Se o registro falhar, o pacote do aplicativo não será excluído do repositório de imagens.
Quando definido como Manual, o pacote do aplicativo não é excluído do repositório de imagens e os usuários precisam chamar explicitamente cmdlet Remove-ServiceFabricApplicationPackage para removê-lo do repositório de imagens.
Um cluster do Service Fabric é configurado com uma política de limpeza. Para usar a política do cluster, especifique Default opção. A configuração do cluster CleanupApplicationPackageOnProvisionSuccess em Management seção determina como a limpeza deve ocorrer. Se definido como true, os pacotes de aplicativos serão excluídos automaticamente pelo runtime do service fabric após o provisionamento bem-sucedido. Se definido como false, o pacote do aplicativo não será excluído do repositório de imagens. O valor padrão dessa configuração de cluster foi definido como false até v6.4, mas há planos para defini-lo como verdadeiro para versões futuras.
Representa o caminho para o pacote de aplicativos sfpkg de onde o pacote de aplicativos pode ser baixado usando protocolos HTTP ou HTTPS. O pacote deve ter sido carregado anteriormente para esse local externo. O URI deve permitir o acesso DE LEITURA para que o Service Fabric possa baixar o arquivo.\nO arquivo sfpkg é um zip que contém o pacote inicial do aplicativo. Dentro do zip, o pacote do aplicativo pode ser compactado ou descompactado. A compactação do pacote de aplicativos dentro do zip é feita em pacotes de código, pacote e dados. Essa compactação pode ser obtida usando Copy-ServiceFabricApplicationPackage com switch -CompressPackage.\nO arquivo sfpkg deve ter a extensão \".sfpkg\".
Especifica o caminho relativo do pacote de tipo de aplicativo no repositório de imagens. Esse caminho foi especificado pelo cmdlet Copy-ServiceFabricApplicationPackage quando o pacote de aplicativos foi copiado para o repositório de imagens.
\n","isRequired":true,"name":"ApplicationPathInImageStore","parameterValueGroup":"","position":"0","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifica o nome do tipo de aplicativo, como ele é definido no manifesto do aplicativo. O nome do tipo de aplicativo e a versão do tipo de aplicativo identificam exclusivamente o tipo de aplicativo.\nIsso é necessário ao provisionar um sfpkg de um repositório externo.
Especifica a versão do tipo de aplicativo, como ela foi definida no manifesto do aplicativo. O nome do tipo de aplicativo e a versão do tipo de aplicativo identificam exclusivamente o tipo de aplicativo.\nIsso é necessário ao provisionar um arquivo de pacote de aplicativo sfpkg de um repositório externo.
O comando retorna assim que a solicitação de registro é aceita pelo cluster. Use o comando Get-ServiceFabricApplicationType para consultar o status da solicitação de registro. Usar essa opção evita a necessidade de fornecer grandes valores de -TimeoutSec ao registrar grandes pacotes de aplicativos.
\n","name":"Async","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifica o período de tempo limite, em segundos, para a operação.
\n","name":"TimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"}],"schema":"PowershellCmdlet","summary":"Registra um tipo de aplicativo do Service Fabric.
\n","syntaxes":["Register-ServiceFabricApplicationType [-ApplicationPathInImageStore]Registra um tipo de aplicativo do Service Fabric.
\n","uid":"ServiceFabric.Register-ServiceFabricApplicationType"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/servicefabric/register-servicefabricapplicationtype?view=azureservicefabricps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/servicefabric/register-servicefabricapplicationtype?view=azureservicefabricps"},"pageMetadata":"O cmdletO pacote de aplicativos pode existir em um local relativo no repositório de imagens ou pode ser um arquivo sfpkg carregado anteriormente em um local externo.
Ao usar o caminho relativo do repositório, o pacote de aplicativos deve existir no repositório de imagens. O pacote pode ser copiado para o repositório de imagens com Copy-ServiceFabricApplicationPackage.
\nAo usar um arquivo sfpkg de um repositório externo, o provisionamento deve fornecer o URI de download para onde o sfpkg foi carregado anteriormente, bem como as informações de tipo de aplicativo.\nO arquivo sfpkg é um zip que contém o pacote inicial do aplicativo e tem a extensão ".sfpkg".\nDentro do zip, o pacote do aplicativo pode ser compactado ou descompactado. A compactação do pacote de aplicativos dentro do zip é feita em pacotes de código, pacote e dados.
Para criar um sfpkg, comece com uma pasta que contenha o pacote de aplicativo original. Se necessário, compacte o pacote com Copy-ServiceFabricApplicationPackage com comutadores -CompressPackage e -SkipCopy.\nEm seguida, use um utilitário para fechar a pasta com a extensão ".sfpkg". Por exemplo, use ZipFile.CreateFromDirectory na pasta do pacote de aplicativos.
Depois de registrar um tipo de aplicativo, você pode usar o cmdlet New-ServiceFabricApplication para criar uma instância do aplicativo. Use o cmdlet Start-ServiceFabricApplicationUpgrade para atualizar um aplicativo existente.
\nQuando o tipo de aplicativo com a versão especificada não for mais necessário, você poderá cancelá-lo usando cmdlet Unregister-ServiceFabricApplicationType.
\nPara gerenciar clusters do Service Fabric, inicie o Windows PowerShell usando a opção Executar como administrador.\nAntes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster.
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\nRegistra um tipo de aplicativo do Service Fabric.\n\" />\r\n\n [-ApplicationPackageCleanupPolicy