Partilhar via

Get-SCScript

  • Referência
Módulo:
VirtualMachineManager

Obtém objetos de script da biblioteca do VMM, que permite exibir ou editar qualquer script, ou exibir, editar ou executar um script do Windows PowerShell se você tiver as permissões apropriadas.

Sintaxe

Get-SCScript
   [-VMMServer <ServerConnection>]
   [-All]
   [<CommonParameters>]
Get-SCScript
   [-VMMServer <ServerConnection>]
   -Name <String>
   [<CommonParameters>]
Get-SCScript
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [<CommonParameters>]
Get-SCScript
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [<CommonParameters>]

Description

O cmdlet Get-SCScript obtém objetos de script da biblioteca do Virtual Machine Manager (VMM). O arquivo de script que um objeto de script representa é armazenado no sistema de arquivos em um servidor de biblioteca. Normalmente, esses scripts são scripts do Windows PowerShell® ou scripts de arquivo de resposta (incluindo arquivos Sysprep.inf e Unattend.xml, que contêm as entradas necessárias para o programa de Instalação do Windows).

Como ilustrado nos exemplos, você pode usar Get-SCScript não apenas para recuperar objetos de script, mas também, se tiver permissões apropriadas, para exibir o conteúdo de um script ou editar um script. Além disso, você pode executar o script se o seguinte for verdadeiro: 1) o script é um script do Windows PowerShell, 2) o script está habilitado em seu servidor e 3) você tem permissões apropriadas (veja o exemplo 5).

Para obter informações sobre como habilitar scripts do Windows PowerShell em seu servidor, digite Get-Help about_Signing, Get-Help Get-ExecutionPolicy -Detailede Get-Help Set-ExecutionPolicy -Detailed.

Exemplos

Exemplo 1: Obter todos os scripts armazenados em todos os servidores de biblioteca do VMM

PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com"

Este comando obtém todos os objetos de script armazenados em compartilhamentos de biblioteca na biblioteca do VMM no VMMServer01 e, em seguida, exibe informações sobre esses scripts para o usuário.

Exemplo 2: Exibir informações especificadas sobre todos os scripts em um servidor de biblioteca

PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" } | Format-List -Property Name, LibraryServer, SharePath

Este comando obtém todos os objetos de script armazenados em LibraryServer01 e exibe o nome, o servidor de biblioteca e o caminho de compartilhamento desses scripts para o usuário.

Exemplo 3: Obter todos os scripts com um nome específico em qualquer servidor de biblioteca do VMM

PS C:\> Get-SCScript -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Sysprep.inf" }

Este comando obtém os objetos de script do arquivo de resposta chamados Sysprep.inf que são armazenados em qualquer servidor de biblioteca no VMMServer01.

Nota: Por padrão, o nome de um objeto de script na biblioteca do VMM é o mesmo nome, incluindo a extensão de arquivo, que o nome do arquivo de script real no servidor de biblioteca.

Exemplo 4: Exibir um script armazenado na biblioteca do VMM

PS C:\> $Script = Get-SCScript | where { $_.Name -eq "SummarizeVMMInfo.ps1"}
PS C:\> Notepad.exe $Script.SharePath

O primeiro comando obtém o objeto de script chamado SummarizeVMMInfo.ps1 da biblioteca do VMM e armazena o objeto na variável $Script.

O segundo comando usa o Bloco de Notas para abrir o script para que você possa exibir seu conteúdo se tiver as permissões apropriadas para ler o script.

Nota: Se você tiver permissões de gravação apropriadas, você também pode editar o script e salvar a nova versão.

Exemplo 5: Executar um script do Windows PowerShell armazenado na biblioteca do VMM

PS C:\> $Script = Get-SCScript | where { $_.Name -eq "SummarizeVMMInfo.ps1" }
PS C:\> &$Script.SharePath

O primeiro comando obtém o objeto de script chamado "SummarizeVMMInfo.ps1" da biblioteca do VMM e armazena o objeto na variável $Script.

O segundo comando usa o operador E comercial (&) para executar o script armazenado no $Script.

Para executar um script do Windows PowerShell armazenado em um compartilhamento de biblioteca do VMM, você deve garantir o seguinte:

  • Você tem permissões de leitura e execução no arquivo de script.

  • Você é membro da função de usuário Administradores do VMM.

  • Você tem permissões para acessar o compartilhamento de biblioteca do VMM.

  • O script do Windows PowerShell está habilitado. Se não for:

Execute o shell de comando do VMM como administrador. 2. Use o cmdlet Set-ExecutionPolicy para definir a política de execução para o nível apropriado para seu ambiente.

Para obter mais informações, digite Get-Help about_Signing, Get-Help Get-ExecutionPolicy -Detailede Get-Help Set-ExecutionPolicy -Detailed

Parâmetros

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentes do objeto pai. Por exemplo, o comando Get-SCVirtualDiskDrive -All obtém todos os objetos de unidade de disco virtual, independentemente do objeto de máquina virtual ou objeto de modelo ao qual cada objeto de unidade de disco virtual está associado.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 da biblioteca.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ID

Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Release

Especifica uma cadeia de caracteres que descreve a liberaçã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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Script

Este cmdlet retorna um objeto Script .