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 .