O cmdlet Set-CMOperatingSystemImage altera as configurações de configuração de uma ou mais imagens do sistema operacional no Configuration Manager.
As imagens do sistema operacional são arquivos de formato .wim e representam uma coleção compactada de arquivos e pastas de referência que Configuration Manager requer para instalar e configurar com êxito um sistema operacional em um computador.
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: alterar as configurações de uma imagem do sistema operacional usando uma ID
Esse comando altera as configurações da imagem do sistema operacional que tem o ID Cm10004f.
O comando renomeia a imagem do sistema operacional, adiciona uma versão e uma descrição e especifica o caminho para os arquivos de origem de instalação da imagem do sistema operacional.
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
-CopyToPackageShareOnDistributionPoint
Type:
Boolean
Aliases:
CopyToPackageShareOnDistributionPoints
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-CustomPackageShareName
Type:
String
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-Description
Especifica uma descrição para a imagem do sistema operacional.
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
-DisconnectUserFromDistributionPoint
Type:
Boolean
Aliases:
DisconnectUsersFromDistributionPoints
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-DisconnectUserFromDistributionPointMins
Type:
UInt32
Aliases:
DisconnectUsersFromDistributionPointsMinutes
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-DisconnectUserFromDistributionPointRetryCount
Type:
UInt32
Aliases:
DisconnectUsersFromDistributionPointsRetries
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-DistributionPointUpdateSchedule
Type:
IResultObject
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-EnableBinaryDeltaReplication
Type:
Boolean
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-ForceWildcardHandling
ForceWildcardHandling processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combinar com DisableWildcardHandling.
Type:
SwitchParameter
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-Id
Especifica uma matriz de IDs de imagens do sistema operacional.
Type:
String
Aliases:
PackageId
Position:
Named
Default value:
None
Required:
True
Accept pipeline input:
False
Accept wildcard characters:
False
-InputObject
Especifica um objeto CMOperatingSystemImage.
Para obter um objeto CMOperatingSystemImage, use o cmdlet Get-CMOperatingSystemImage .
Type:
IResultObject
Position:
Named
Default value:
None
Required:
True
Accept pipeline input:
True
Accept wildcard characters:
False
-MulticastAllow
Type:
Boolean
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-MulticastEncrypt
Type:
Boolean
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-MulticastTransferOnly
Type:
Boolean
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-Name
Especifica o nome de uma imagem do sistema operacional.
Type:
String
Position:
Named
Default value:
None
Required:
True
Accept pipeline input:
False
Accept wildcard characters:
False
-NewName
Especifica o novo nome de uma imagem do sistema operacional.
Type:
String
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
Type:
SwitchParameter
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-Path
Especifica o caminho de rede para o arquivo .wim de fonte de imagem do sistema operacional.
Type:
String
Aliases:
PackageSourcePath
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-PersistContentInCache
Type:
Boolean
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-PrestageBehavior
Type:
PrestageBehavior
Accepted values:
ManualCopy, DownloadDelta, OnDemand
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-Priority
Especifica uma alteração para a prioridade do tipo de implantação.
Os valores válidos são: Aumentar e Diminuir.
Type:
Priority
Accepted values:
High, Medium, Low
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-Reload
Aplica-se à versão 2006 e posterior. Se você alterar as propriedades da imagem usando uma ferramenta externa, use essa opção para recarregar as informações no banco de dados do site.
Type:
SwitchParameter
Aliases:
ReloadImage
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-SendToPreferredDistributionPoint
Type:
Boolean
Aliases:
SendToPreferredDistributionPoints
Position:
Named
Default value:
None
Required:
False
Accept pipeline input:
False
Accept wildcard characters:
False
-Version
Especifica a versão da imagem do sistema operacional.
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.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.