Set-CMOperatingSystemInstaller

Referenz

Modul:: ConfigurationManager

Ändert die Konfigurationseinstellungen von Betriebssystemupgradepaketen.

Syntax

Set-CMOperatingSystemInstaller
   [-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>]

Set-CMOperatingSystemInstaller
   [-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>]

Set-CMOperatingSystemInstaller
   [-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>]

Beschreibung

Das Cmdlet "Set-CMOperatingSystemInstaller" ändert die Konfigurationseinstellungen eines oder mehrerer Betriebssystemupgradepakete in Configuration Manager. Ein Betriebssystemupgradepaket enthält alle Dateien, die Configuration Manager benötigt, um ein Windows Betriebssystem auf einem Referenzcomputer zu installieren.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Ändern der Einstellungen für ein Betriebssystemupgradepaket mithilfe eines Namens

Mit diesem Befehl werden die Konfigurationseinstellungen des Betriebssystemupgradepakets namens Win8x64 geändert. Der Befehl benennt das Betriebssystemupgradepaket um, fügt eine Version und Beschreibung hinzu und gibt den Pfad zu den Installationsquelldateien des Betriebssystemupgradepakets an.

Set-CMOperatingSystemInstaller -Name "Win8x64" -NewName "OsiWin8x64" -Version "I20B" -Description "Dept02 Sys Install" -Path "\\Win2k3X64contoso\Public\OSD\win8x64"

Beispiel 2: Hinzufügen eines Betriebssystemupgradepakets zu einem Sicherheitsbereich mithilfe eines Namens

Mit diesem Befehl wird dem Sicherheitsbereich "SecScope02" für das Betriebssystemupgradepaket "InstPkg01" eine Mitgliedschaft hinzugefügt.

Set-CMOperatingSystemInstaller -SecurityScopeAction AddMembership -SecurityScopeName "SecScope02" -Name "InstPkg01"

Beispiel 3: Entfernen eines Betriebssystemupgradepakets aus einem Sicherheitsbereich

Mit diesem Befehl wird die Mitgliedschaft im Sicherheitsbereich secScope02 für das Betriebssystemupgradepaket namens InstPkg01 entfernt.

Set-CMOperatingSystemInstaller -SecurityScopeAction RemoveMembership -SecurityScopeName "SecScope02" -Name "InstPkg01"

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-CopyToPackageShareOnDistributionPoint

Type:	Boolean
Aliases:	CopyToPackageShareOnDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomPackageShareName

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

-Description

Gibt eine Beschreibung für das Betriebssystemupgradepaket an.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-DisconnectUserFromDistributionPoint

Type:	Boolean
Aliases:	DisconnectUsersFromDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointMins

Type:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointRetryCount

Type:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsRetries
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointUpdateSchedule

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

-EnableBinaryDeltaReplication

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-Id

Gibt ein Array von IDs von Betriebssystemupgradepaketen an.

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

-InputObject

Gibt ein CMOperatingSystemInstaller -Objekt an. Verwenden Sie das Cmdlet "Get-CMOperatingSystemInstaller", um ein CMOperatingSystemInstaller-Objekt abzurufen.

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

-MulticastAllow

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

-MulticastEncrypt

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

-MulticastTransferOnly

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

-Name

Gibt den Namen eines Betriebssystemupgradepakets an.

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

-NewName

Gibt den neuen Namen eines Betriebssystemupgradepakets an.

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

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

-Path

Gibt den Netzwerkpfad zu den Installationsquelldateien eines Betriebssystemupgradepakets an.

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

-PersistContentInCache

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

-PrestageBehavior

Type:	PrestageBehavior
Accepted values:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

Gibt eine Änderung für die Priorität des Bereitstellungstyps an. Gültige Werte sind: Erhöhen und Verkleinern.

Type:	Priority
Accepted values:	High, Medium, Low
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Reload

Gilt für Version 2006 und höher. Wenn Sie die Bildeigenschaften mithilfe eines externen Tools ändern, verwenden Sie diese Option, um die Informationen in der Websitedatenbank neu zu laden.

Type:	SwitchParameter
Aliases:	ReloadImage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendToPreferredDistributionPoint

Type:	Boolean
Aliases:	SendToPreferredDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Version

Gibt die Version eines Betriebssystemupgradepakets an.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object