New-CMOperatingSystemImage
Criar uma imagem do SO.
Sintaxe
New-CMOperatingSystemImage
[-Description <String>]
-Name <String>
-Path <String>
[-Index <Int32>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Utilize este cmdlet para adicionar uma imagem do SO a um site do Configuration Manager. As imagens do SO são ficheiros WIM que representam uma coleção comprimida de ficheiros e pastas de referência. O Configuration Manager utiliza estas imagens com uma sequência de tarefas para implementar um SO num computador. Para obter mais informações, veja Gerir imagens do SO com o Configuration Manager.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Criar uma imagem do SO
Este comando cria a imagem do SO denominada "Windows 10 mais recente" a partir do caminho de rede para os ficheiros de origem de instalação da imagem do SO.
New-CMOperatingSystemImage -Name "Windows 10 latest" -Path "\\Contoso01\CM\Images\win10_latest.wim"Parâmetros
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Description
Especifique uma descrição opcional para o ajudar a identificar a imagem. O comprimento máximo é de 127 carateres.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Index
Quando adiciona este parâmetro, o site extrai uma única imagem de índice de uma imagem com vários índices. Em seguida, coloca a nova imagem na mesma pasta de origem que a imagem original.
A utilização desta opção resulta num ficheiro de imagem mais pequeno e numa manutenção offline mais rápida. Também suporta o processo para Otimizar a manutenção de imagens para um ficheiro de imagem mais pequeno após a aplicação de atualizações de software.
| Tipo: | Int32 |
| Aliases: | ImageIndex |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifique o nome da imagem do SO. O comprimento máximo é de 50 carateres.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Path
Especifique o caminho de rede para o ficheiro WIM da imagem do SO. O caminho tem de incluir o nome do ficheiro WIM com a .wim extensão.
| Tipo: | String |
| Aliases: | PackageSourcePath |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Version
Especifique uma versão opcional da imagem do SO. Este valor destina-se ao controlo de versões interno e não à versão do SO. O comprimento máximo é de 32 carateres.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_ImagePackage classe WMI de servidor.