Set-SCApplicationPackage
Modifica as propriedades de um pacote de aplicativos.
Sintaxe
Set-SCApplicationPackage
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-ApplicationPackage] <ApplicationPackage[]>
[-EncryptionKey <PSCredential>]
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCApplicationPackage
[-VMMServer <ServerConnection>]
[-ApplicationPackage] <ApplicationPackage[]>
[-SetAsEquivalent]
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
O cmdlet Set-SCApplicationPackage modifica as propriedades de um pacote de aplicativos armazenado na biblioteca do VMM (Virtual Machine Manager).
Exemplos
Exemplo 1: atualizar a descrição de um pacote de aplicativos
PS C:\> $AppPackage = Get-SCApplicationPackage -Name "WebApp01.zip"
PS C:\> Set-SCApplicationPackage -ApplicationPackage $AppPackage -Description "Web application to install on a service."O primeiro comando obtém o objeto de pacote de aplicativo chamado WebApp01.zip e armazena o objeto na variável $AppPackage.
O segundo comando atualiza a descrição do WebApp01.zip.
Parâmetros
-ApplicationPackage
Especifica uma matriz de objetos de pacote de aplicativos.
| Tipo: | ApplicationPackage[] |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Description
Declara uma descrição para o objeto especificado.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Enabled
Habilita um objeto quando definido como $True ou desabilita um objeto quando definido como $False. Por exemplo, se você quiser atualizar o software em um modelo de máquina virtual, poderá desabilitar o objeto de modelo na biblioteca do VMM para impedir temporariamente que os usuários usem esse objeto.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EncryptionKey
Especifica as credenciais a serem usadas como uma chave de criptografia ao adicionar um host Hyper-V localizado em uma rede de perímetro ao VMM.
Formato de exemplo: -SecurityFile "C:\SecurityFile.txt" -EncryptionKey $Key
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-FamilyName
Especifica um nome de família para um recurso físico na biblioteca do VMM. Esse valor é usado em conjunto com Versão, Namespace e Tipo para estabelecer equivalência entre os recursos da biblioteca.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-JobVariable
Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifica o nome de um objeto do VMM.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Owner
Especifica o proprietário de um objeto VMM na forma de uma conta de usuário de domínio válida.
- Formato de exemplo:
-Owner "Contoso\PattiFuller" - Formato de exemplo:
-Owner "PattiFuller@Contoso"
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PROTipID
Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Release
Especifica uma cadeia de caracteres que descreve a versão de um recurso de biblioteca. O VMM cria automaticamente um valor de versão para cada recurso importado para a biblioteca. Depois que o recurso tiver sido importado, a cadeia de caracteres poderá ser personalizada.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SetAsEquivalent
Indica que o cmdlet marca vários pacotes de aplicativos como equivalentes.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SharePath
Especifica um caminho para um compartilhamento de biblioteca válido em um servidor de biblioteca existente que usa um caminho UNC (Convenção Universal de Nomenclatura).
Formato de exemplo: -SharePath "\\LibServer01\LibShare"
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UserRole
Especifica um objeto de função de usuário.
| Tipo: | UserRole |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Tipo: | ServerConnection |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
Saídas
ApplicationPackage
Esse cmdlet retorna um objeto ApplicationPackage