Set-SCScript
Altera as propriedades de um script armazenado na biblioteca do VMM.
Syntax
Set-SCScript
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-Script] <Script>
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]Set-SCScript
[-VMMServer <ServerConnection>]
[-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]Description
O cmdlet Set-SCScript altera uma ou mais propriedades de um script armazenado na biblioteca do VMM (Virtual Machine Manager).
As propriedades que você pode alterar incluem:
- Descrição
- Habilitada
- Name
- Proprietário
- Sharepath
Objetos script representam arquivos de script armazenados em um compartilhamento de biblioteca em um servidor de biblioteca. Normalmente, esses scripts são Windows PowerShell ® scripts ou arquivos de resposta (como um Sysprep.inf ou um arquivo Unattend.xml) que contêm as entradas necessárias para o programa de Instalação do Windows.
Exemplos
Exemplo 1: alterar a descrição de um script
PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "Sysprep.inf" }
PS C:\> Set-SCScript -Script $Script -Description "Windows Server 2008 R2 Sysprep Answer File"O primeiro comando recupera o objeto de script de arquivo de resposta chamado Sysprep.inf da biblioteca no VMMServer01 e armazena o objeto na variável $Script.
O segundo comando altera a descrição desse objeto de script para "Windows Server 2008 R2 Sysprep Answer File".
Exemplo 2: Desabilitar um script Windows PowerShell armazenado na biblioteca do VMM
PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1" }
PS C:\> Set-SCScript -Script $Script -Enabled $FALSEO primeiro comando obtém o objeto de script do PowerShell chamado AddHost.ps1 e armazena o objeto na variável $Script.
O segundo comando desabilita o script armazenado no $Script.
Exemplo 3: especificar um proprietário para todos os scripts com um proprietário desconhecido
PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCScript -Owner "Contoso\PattiFuller"Esse comando obtém todos os objetos de script da biblioteca do VMM cujo proprietário é Desconhecido e especifica um proprietário para cada objeto de script.
Parâmetros
-Description
Especifica uma descrição para o script.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FamilyName
Especifica um nome de família para um recurso físico na biblioteca do VMM. Esse valor é usado em conjunto com Release, Namespace e Type para estabelecer equivalência entre os recursos de biblioteca.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica o nome de um objeto VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válido.
- Formato de exemplo:
-Owner "Contoso\PattiFuller" - Formato de exemplo:
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Script
Especifica um objeto de script do VMM.
| Type: | Script |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Scripts
Especifica uma matriz de objetos de script.
| Type: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
Especifica um objeto de função de usuário.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
Script
Esse cmdlet retorna um objeto Script .
Observações
- Requer um objeto de script do VMM, que pode ser recuperado usando o cmdlet Get-SCScript .