Compartilhar via


Get-SCScript

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

All (Padrão)

Get-SCScript
    [-VMMServer <ServerConnection>]
    [-All]
    [<CommonParameters>]

NameParamSet

Get-SCScript
    -Name <String>
    [-VMMServer <ServerConnection>]
    [<CommonParameters>]

EquivalentResourceParamSet

Get-SCScript
    -FamilyName <String>
    [-VMMServer <ServerConnection>]
    [-Release <String>]
    [<CommonParameters>]

ID

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 para 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 as permissões apropriadas (consulte 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, 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

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 do arquivo de resposta chamados Sysprep.inf que são 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 do 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.

Observação: se você tiver as 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 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 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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

All
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EquivalentResourceParamSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ID

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

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ID
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome de um objeto do VMM.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NameParamSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EquivalentResourceParamSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

Tipo:ServerConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

Script

Esse cmdlet retorna um objeto Script .