Set-SCScript

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de um script armazenado na biblioteca 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 Virtual Machine Manager (VMM).

As propriedades que pode alterar incluem:

  • Description
  • Ativado
  • Name
  • Proprietário
  • SharePath

Os objetos de script representam ficheiros de script armazenados numa partilha de biblioteca num servidor de biblioteca. Normalmente, estes scripts são Windows PowerShell ® scripts ou ficheiros de resposta (como um Sysprep.inf ou um ficheiro Unattend.xml) que contêm as entradas necessárias para o programa de Configuraçã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 ficheiro de resposta chamado Sysprep.inf da biblioteca em VMMServer01 e, em seguida, armazena o objeto na variável $Script.

O segundo comando altera a descrição deste objeto de script para "Windows Server 2008 R2 Sysprep Answer File".

Exemplo 2: Desativar um script Windows PowerShell armazenado na biblioteca 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 $FALSE

O primeiro comando obtém o objeto de script PowerShell nomeado AddHost.ps1 e armazena o objeto na variável $Script.

O segundo comando desativa o script armazenado em $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"

Este comando obtém todos os objetos de script da biblioteca VMM cujo proprietário é Desconhecido e, em seguida, especifica um proprietário para cada objeto de script.

Parâmetros

-Description

Especifica uma descrição para o guião.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

Ativa um objeto quando definido para $True ou desativa um objeto quando definido para $False. Por exemplo, se pretender atualizar o software num modelo de máquina virtual, pode desativar o objeto do modelo na biblioteca VMM para impedir temporariamente os utilizadores de utilizarem 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 VMM. Este valor é usado em conjunto com Release, Namespace e Type para estabelecer equivalência entre os recursos da biblioteca.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este 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 sob a forma de uma conta de utilizador de domínio válida.

  • 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 o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Release

Especifica uma cadeia que descreve a libertação de um recurso de biblioteca. A VMM cria automaticamente um valor de libertação para cada recurso importado para a biblioteca. Depois de importado o recurso, a cadeia pode ser personalizada.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha 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 VMM.

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scripts

Especifica uma variedade 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 uma partilha de biblioteca válida num servidor de biblioteca existente que usa um caminho da Convenção Universal de Nomeação (UNC).

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 do utilizador.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Saídas

Script

Este cmdlet devolve um objeto Script .

Notas

  • Requer um objeto de script VMM, que pode ser recuperado utilizando o cmdlet Get-SCScript .