Share via

New-CMOperatingSystemImage

  • Referência
Módulo:
ConfigurationManager

Crie uma imagem do sistema operacional.

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifique uma descrição opcional para ajudá-lo a identificar a imagem. O comprimento máximo é de 127 caracteres.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Aliases:ImageIndex
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome da imagem do sistema operacional. O comprimento máximo é de 50 caracteres.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PackageSourcePath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.