Sdílet prostřednictvím


Set-CMOperatingSystemImage

SYNOPSIS

Změní nastavení konfigurace imagí operačního systému.

SYNTAX

SetByValueMandatory (výchozí)

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

Rutina Set-CMOperatingSystemImage mění nastavení konfigurace jedné nebo více imagí operačního systému v Správce konfigurace. Image operačního systému jsou formátovací soubory .wim a představují komprimovanou kolekci referenčních souborů a složek, které Správce konfigurace k úspěšné instalaci a konfiguraci operačního systému na počítači.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Změna nastavení image operačního systému pomocí ID

Tento příkaz změní nastavení konfigurace image operačního systému s ID Cm10004f. Příkaz přejmenuje image operačního systému, přidá verzi a popis a určí cestu ke zdrojovým instalačním souborům image operačního systému.

Set-CMOperatingSystemImage -Id "Cm10004f" -NewName "Microsoft Windows 8 (x64)" -Version "I20C" -Description "Dept02 Sys Image" -Path "\\Contoso\Public\OSD\win8x64.wim"

Příklad 2: Přidání image operačního systému do oboru zabezpečení pomocí názvu

Tento příkaz přidá členství do oboru zabezpečení s názvem SecScope02 pro image operačního systému s názvem ImagePkg01.

Set-CMOperatingSystemImage -SecurityScopeAction AddMembership -SecurityScopeName "SecScope02" -Name "ImagePkg01"

Příklad 3: Odebrání image operačního systému z oboru zabezpečení

Tento příkaz odebere členství z oboru zabezpečení s názvem SecScope02 pro image operačního systému s názvem ImagePkg01.

Set-CMOperatingSystemImage -SecurityScopeAction RemoveMembership -SecurityScopeName "SecScope02" -Name "ImagePkg01"

PARAMETERS

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Description (Popis)

Určuje popis image operačního systému.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s 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

-EnableBinaryDeltaReplication

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

ForceWildcardHandling zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nelze kombinovat s disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Určuje pole ID imagí operačního systému.

Type: String
Parameter Sets: SetById
Aliases: PackageId

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

-InputObject

Určuje objekt CMOperatingSystemImage. K získání objektu CMOperatingSystemImage použijte rutinu 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

-MulticastTransferOnly

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Určuje název image operačního systému.

Type: String
Parameter Sets: SetByName
Aliases:

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

-NewName

Určuje nový název image operačního systému.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Přidáním tohoto parametru vrátíte objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Určuje síťovou cestu ke zdrojovému souboru .wim image operačního systému.

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

-Priority (Priorita)

Určuje změnu priority typu nasazení. Platné hodnoty jsou: Zvýšit a Snížit.

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

-Reload (Znovu načíst)

Platí pro verzi 2006 a novější. Pokud změníte vlastnosti bitové kopie pomocí externího nástroje, použijte tuto možnost k opětovnému načtení informací v databázi lokality.

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

-Version

Určuje verzi image operačního systému.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

POZNÁMKY

Get-CMOperatingSystemImage

New-CMOperatingSystemImage

Remove-CMOperatingSystemImage

Get-CMOperatingSystemImageUpdateSchedule