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.