Get-SCScript

Referência

Módulo:: VirtualMachineManager

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

Syntax

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 script representa é armazenado no sistema de arquivos em um servidor de biblioteca. Normalmente, esses scripts são scripts 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 as 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 Windows PowerShell, 2) o script está habilitado no servidor e 3) você tem as permissões apropriadas (veja o exemplo 5).

Para obter informações sobre como habilitar Windows PowerShell scripts no 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 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" }

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 de 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 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.
Windows PowerShell script está habilitado. Se não estiverem:

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.

Type:	SwitchParameter
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 a equivalência entre os recursos da biblioteca.

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

-ID

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

Type:	Guid
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:	True
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 for importado, a cadeia de caracteres poderá ser personalizada.

Type:	String
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 .