Set-CMOperatingSystemImage
SYNOPSIS
Altera as definições de configuração das imagens de SO.
SYNTAX
SetByValueMandatory (Padrão)
Set-CMOperatingSystemImage [-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>] [-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>]
-InputObject <IResultObject> [-MulticastAllow <Boolean>] [-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>] [-NewName <String>] [-PassThru] [-Path <String>]
[-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>] [-Priority <Priority>] [-Reload]
[-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetById
Set-CMOperatingSystemImage [-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>] [-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>] -Id <String>
[-MulticastAllow <Boolean>] [-MulticastEncrypt <Boolean>] [-MulticastTransferOnly <Boolean>]
[-NewName <String>] [-PassThru] [-Path <String>] [-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>] [-Priority <Priority>] [-Reload]
[-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetByName
Set-CMOperatingSystemImage [-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>] [-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>]
[-MulticastAllow <Boolean>] [-MulticastEncrypt <Boolean>] [-MulticastTransferOnly <Boolean>] -Name <String>
[-NewName <String>] [-PassThru] [-Path <String>] [-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>] [-Priority <Priority>] [-Reload]
[-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
O cmdlet Set-CMOperatingSystemImage altera as definições de configuração de uma ou mais imagens de SO no Gestor de Configuração. As imagens os sistemas operativos são ficheiros de formato .wim e representam uma coleção comprimida de ficheiros e pastas de referência que o Gestor de Configuração necessita para instalar e configurar com sucesso um SISTEMA num computador.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Alterar as definições para uma imagem de SO utilizando um ID
Este comando altera as definições de configuração da imagem SO que tem o ID Cm10004f. O comando renomea a imagem so, adiciona uma versão e descrição e especifica o caminho para os ficheiros de origem de instalação da imagem SO.
Set-CMOperatingSystemImage -Id "Cm10004f" -NewName "Microsoft Windows 8 (x64)" -Version "I20C" -Description "Dept02 Sys Image" -Path "\\Contoso\Public\OSD\win8x64.wim"
Exemplo 2: Adicionar uma imagem de SO a um âmbito de segurança utilizando um nome
Este comando adiciona adesão ao âmbito de segurança chamado SecScope02 para a imagem oss chamada ImagePkg01.
Set-CMOperatingSystemImage -SecurityScopeAction AddMembership -SecurityScopeName "SecScope02" -Name "ImagePkg01"
Exemplo 3: Remover uma imagem de SO de um âmbito de segurança
Este comando remove a adesão do âmbito de segurança denominado SecScope02 para a imagem SO chamada ImagePkg01.
Set-CMOperatingSystemImage -SecurityScopeAction RemoveMembership -SecurityScopeName "SecScope02" -Name "ImagePkg01"
PARAMETERS
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CopyToPackageShareOnDistributionPoint
Type: Boolean
Parameter Sets: (All)
Aliases: CopyToPackageShareOnDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CustomPackageShareName
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Descrição
Especifica uma descrição para a imagem do SO.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPoint
Type: Boolean
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointMins
Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsMinutes
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointRetryCount
Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsRetries
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointUpdateSchedule
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableBinaryDeltaReplicação
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
ForceWildcardHandling processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combinar com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifica uma série de IDs de imagens de SO.
Type: String
Parameter Sets: SetById
Aliases: PackageId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifica um objeto CMOperatingSystemImage. Para obter um objeto CMOperatingSystemImage, utilize o cmdlet Get-CMOperatingSystemImage.
Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-MulticastAllow
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastEncrypt
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastTransferOnamente
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifica o nome de uma imagem de SO.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Novo Nome
Especifica o novo nome de uma imagem de SO.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Especifica o caminho da rede para a fonte de imagem SO .wim.
Type: String
Parameter Sets: (All)
Aliases: PackageSourcePath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistContentInCache
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestageBehavior
Type: PrestageBehavior
Parameter Sets: (All)
Aliases:
Accepted values: ManualCopy, DownloadDelta, OnDemand
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Prioridade
Especifica uma alteração para a prioridade do tipo de implantação. Os valores válidos são: Aumentar e Diminuir.
Type: Priority
Parameter Sets: (All)
Aliases:
Accepted values: High, Medium, Low
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Recarregar
Aplica-se à versão 2006 e mais tarde. Se alterar as propriedades de imagem utilizando uma ferramenta externa, utilize esta opção para recarregar as informações na base de dados do site.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ReloadImage
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendToPreferredDistributionPoint
Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Versão
Especifica a versão da imagem so.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.