Compartilhar 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 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 VMM (Virtual Machine Manager). 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).

Conforme 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ê poderá executar o script se o seguinte for verdadeiro: 1) o script é um script do Windows PowerShell, 2) o script está habilitado no 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"

Esse comando obtém todos os objetos de script armazenados em compartilhamentos de biblioteca na biblioteca do VMM no VMMServer01 e 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

Esse comando obtém todos os objetos de script armazenados no 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" }

Esse comando obtém os objetos de script de arquivo de resposta chamados Sysprep.inf armazenados em qualquer servidor de biblioteca no VMMServer01.

Observação: por padrão, o nome de um objeto de script na biblioteca do VMM é o mesmo nome, incluindo a extensão de arquivo, como 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.

Observação: se você tiver permissões de gravação apropriadas, também poderá 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 ampersand (&) para executar o script armazenado em $Script.

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

  • Você leu e executou permissões 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 independentemente 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
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

-ID

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

Tipo:Guid
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:True
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: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

Script

Esse cmdlet retorna um objeto Script.