Compartilhar via

New-CMOperatingSystemImage

  • Referência
Módulo:
ConfigurationManager

Crie uma imagem do sistema operacional.

Sintaxe

New-CMOperatingSystemImage
   [-Description <String>]
   -Name <String>
   -Path <String>
   [-Index <Int32>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para adicionar uma imagem do sistema operacional a um site Configuration Manager. As imagens do sistema operacional são arquivos WIM que representam uma coleção compactada de arquivos e pastas de referência. Configuration Manager usa essas imagens com uma sequência de tarefas para implantar um sistema operacional em um computador. Para obter mais informações, consulte Gerenciar imagens do sistema operacional com Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: criar uma imagem do sistema operacional

Esse comando cria a imagem do sistema operacional chamada "Windows 10 mais recente" do caminho de rede para os arquivos de origem de instalação da imagem do sistema operacional.

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 ajudá-lo a identificar a imagem. O comprimento máximo é de 127 caracteres.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 você adiciona esse parâmetro, o site extrai uma única imagem de índice de uma imagem de vários índices. Em seguida, ele coloca a nova imagem na mesma pasta de origem que a imagem original.

O uso dessa opção resulta em um arquivo de imagem menor e uma manutenção offline mais rápida. Ele também dá suporte ao processo para Otimizar a manutenção de imagem para um arquivo de imagem menor depois de aplicar 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 sistema operacional. O comprimento máximo é de 50 caracteres.

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 arquivo WIM de imagem do sistema operacional. O caminho precisa incluir o nome do arquivo 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 sistema operacional. Esse valor é para sua versão interna, não para a versão do sistema operacional. O comprimento máximo é de 32 caracteres.

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 esse objeto retornado e suas propriedades, consulte SMS_ImagePackage classe WMI do servidor.