Como gerenciar pacotes do App-V em execução em um computador autônomo usando Windows PowerShell
Aplica-se a:
- Windows 10
- Windows 11
As seções a seguir explicam como executar várias tarefas de gerenciamento em um computador cliente autônomo com cmdlets Windows PowerShell.
Retornar uma lista de pacotes
Insira o cmdlet Get-AppvClientPackage para retornar uma lista de pacotes com direito a um usuário específico. Seus parâmetros são -Name, -Version, -PackageID e -VersionID.
Por exemplo:
Get-AppvClientPackage –Name "ContosoApplication" -Version 2
Adicionar um pacote
Use o cmdlet Add-AppvClientPackage para adicionar um pacote a um computador.
Importante
Este exemplo só adiciona um pacote. Ele não publica o pacote para o usuário ou o computador.
Por exemplo:
$Contoso = Add-AppvClientPackage \\\\path\\to\\appv\\package.appv
Publicar um pacote
Use o cmdlet Publish-AppvClientPackage para publicar um pacote que foi adicionado a um usuário específico ou globalmente a qualquer usuário no computador.
Insira o cmdlet com o nome do aplicativo para publicá-lo no usuário.
Publish-AppvClientPackage "ContosoApplication"
Para publicar o aplicativo globalmente, basta adicionar o parâmetro -Global .
Publish-AppvClientPackage "ContosoApplication" -Global
Publicar um pacote em um usuário específico
Observação
Você deve usar o Pacote hotfix do App-V 5.0 SP2 5 ou posterior para usar esse parâmetro.
Um administrador pode publicar um pacote em um usuário específico especificando o parâmetro opcional –UserSID com o cmdlet Publish-AppvClientPackage , em que -UserSID representa o SID (identificador de segurança) do usuário final.
Para usar este parâmetro:
- Você pode executar esse cmdlet na sessão de usuário ou administrador.
- Você deve estar conectado com credenciais administrativas para usar o parâmetro.
- O usuário final deve ser conectado.
- Você deve fornecer o SID (identificador de segurança) do usuário final.
Por exemplo:
Publish-AppvClientPackage "ContosoApplication" -UserSID S-1-2-34-56789012-3456789012-345678901-2345
Adicionar e publicar um pacote
Use o cmdlet Add-AppvClientPackage para adicionar um pacote a um computador e publicá-lo ao usuário.
Por exemplo:
Add-AppvClientPackage <path to App-V package> | Publish-AppvClientPackage
Desmarmar um pacote existente
Use o cmdlet Unpublish-AppvClientPackage para desmarcar um pacote que tem direito a um usuário, mas não remover o pacote do computador.
Por exemplo:
Unpublish-AppvClientPackage "ContosoApplication"
Desmarmar um pacote para um usuário específico
Observação
Você deve usar o Pacote hotfix do App-V 5.0 SP2 5 ou posterior para usar esse parâmetro.
Um administrador pode desmarcar um pacote para um usuário específico usando o parâmetro opcional -UserSID com o cmdlet Unpublish-AppvClientPackage , em que -UserSID representa o SID (identificador de segurança) do usuário final.
Para usar este parâmetro:
- Você pode executar esse cmdlet na sessão de usuário ou administrador.
- Você deve entrar com credenciais administrativas para usar o parâmetro.
- O usuário final deve ser conectado.
- Você deve fornecer o SID (identificador de segurança) do usuário final.
Por exemplo:
Unpublish-AppvClientPackage "ContosoApplication" -UserSID S-1-2-34-56789012-3456789012-345678901-2345
Remover um pacote existente
Use o cmdlet Remove-AppvClientPackage para remover um pacote do computador.
Por exemplo:
Remove-AppvClientPackage "ContosoApplication"
Observação
Cmdlets app-V foram atribuídos a variáveis para os exemplos anteriores apenas para clareza; atribuição não é um requisito. A maioria dos cmdlets pode ser combinada conforme exibido em Adicionar e publicar um pacote. Para obter um tutorial detalhado, consulte App-V 5.0 Client PowerShell Deep Dive.
Habilitar apenas os administradores a publicar ou desmarmar pacotes
Começando no App-V 5.0 SP3, você pode usar o cmdlet Set-AppvClientConfiguration e o parâmetro -RequirePublishAsAdmin para permitir que apenas administradores (não usuários finais) publiquem ou publiquem pacotes.
Você pode definir o parâmetro -RequirePublishAsAdmin para os seguintes valores:
- 0: False
- 1: True
Por exemplo:
Set-AppvClientConfiguration –RequirePublishAsAdmin1
Para usar o console de Gerenciamento do App-V para definir essa configuração, consulte Como publicar um pacote usando o Console de Gerenciamento.
Sobre pacotes pendentes: UserPending e GlobalPending
Começando no App-V 5.0 SP2, se você executar um cmdlet Windows PowerShell que afeta um pacote atualmente em uso, a tarefa que você está tentando executar será colocada em um estado pendente. Por exemplo, se você tentar publicar um pacote quando um aplicativo nesse pacote estiver sendo usado e executar Get-AppvClientPackage, o status pendente será exibido na saída do cmdlet da seguinte maneira:
| Item de saída de cmdlet | Descrição |
|---|---|
| UserPending | Indica se o pacote listado tem uma tarefa pendente que está sendo aplicada ao usuário: -Verdade -False |
| GlobalPending | Indica se o pacote listado tem uma tarefa pendente que está sendo aplicada globalmente ao computador: -Verdade -False |
A tarefa pendente será executada posteriormente, de acordo com as seguintes regras:
| Tipo de tarefa | Regra aplicável |
|---|---|
| Baseado no usuário (por exemplo, publicando um pacote em um usuário) |
A tarefa pendente será executada após o usuário fazer logon e fazer logon novamente. |
| Globalmente baseado (por exemplo, habilitando um grupo de conexão globalmente) |
A tarefa pendente será executada quando o computador for desligado e reiniciado. |
Para obter mais informações sobre tarefas pendentes, consulte Atualizar um pacote de App-V em uso.