Start-CMDistributionPointUpgrade
Aktualisiert einen freigegebenen Verteilungspunkt.
Syntax
Start-CMDistributionPointUpgrade
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-AllowRespondIncomingPxeRequest <Boolean>]
[-CertificatePassword <SecureString>]
-CertificatePath <String>
[-ClientCommunicationMode <ComputerCommunicationType>]
[-ClientConnectionType <ClientConnectionTypes>]
[-ContentValidationPriority <Priority>]
-DestinationSiteCode <String>
[-EnableAnonymous <Boolean>]
[-EnableNonWdsPxe <Boolean>]
[-EnablePxeSupport <Boolean>]
[-EnableUnknownComputerSupport <Boolean>]
[-ForceWhenDuplicateCertificate <Boolean>]
[-InitiateConnection <Boolean>]
-InputObject <IResultObject>
[-InstallationAccount <IResultObject>]
[-InstallIis <Boolean>]
[-MacAddressForRespondingPxeRequest <String[]>]
[-MinFreeSpaceMB <Int32>]
[-PathForSavingMigratedPackage <String>]
[-PrimaryContentLibraryLocation <DriveType>]
[-PrimaryPackageShareLocation <DriveType>]
[-PublicFqdn <String>]
[-PxePassword <SecureString>]
[-PxeServerResponseDelaySec <Int32>]
[-SecondaryContentLibraryLocation <DriveType>]
[-SecondaryPackageShareLocation <DriveType>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-ValidateContentSchedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMDistributionPointUpgrade
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-AllowRespondIncomingPxeRequest <Boolean>]
-CertificateExpirationTimeUtc <DateTime>
[-ClientCommunicationMode <ComputerCommunicationType>]
[-ClientConnectionType <ClientConnectionTypes>]
[-ContentValidationPriority <Priority>]
-DestinationSiteCode <String>
[-EnableAnonymous <Boolean>]
[-EnableNonWdsPxe <Boolean>]
[-EnablePxeSupport <Boolean>]
[-EnableUnknownComputerSupport <Boolean>]
[-InitiateConnection <Boolean>]
-InputObject <IResultObject>
[-InstallationAccount <IResultObject>]
[-InstallIis <Boolean>]
[-MacAddressForRespondingPxeRequest <String[]>]
[-MinFreeSpaceMB <Int32>]
[-PathForSavingMigratedPackage <String>]
[-PrimaryContentLibraryLocation <DriveType>]
[-PrimaryPackageShareLocation <DriveType>]
[-PublicFqdn <String>]
[-PxePassword <SecureString>]
[-PxeServerResponseDelaySec <Int32>]
[-SecondaryContentLibraryLocation <DriveType>]
[-SecondaryPackageShareLocation <DriveType>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-ValidateContentSchedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Start-CMDistributionPointUpgrade aktualisiert einen freigegebenen Verteilungspunkt auf einen Configuration Manager Verteilungspunkt.
Wenn Sie von einer Configuration Manager 2007-Quellhierarchie migrieren, können Sie einen freigegebenen Verteilungspunkt aktualisieren, um ihn zu einem Configuration Manager Verteilungspunkt zu machen. Sie können Verteilungspunkte sowohl an primären als auch an sekundären Standorten aktualisieren. Der Upgradeprozess entfernt den Verteilungspunkt aus der Configuration Manager 2007-Hierarchie und macht ihn zu einem Standortsystemserver in der Configuration Manager Hierarchie. Dieser Prozess kopiert auch den vorhandenen Inhalt, der sich auf dem Verteilungspunkt befindet, an einen neuen Speicherort auf dem Verteilungspunktcomputer. Der Upgradeprozess ändert dann die Kopie des Inhalts, um den Configuration Manager einzelnen Instanzspeicher für die Verwendung mit Configuration Manager Inhaltsbereitstellung zu erstellen. Daher müssen Sie beim Upgrade eines Verteilungspunkts keine migrierten Inhalte neu verteilen, die auf dem Configuration Manager 2007-Verteilungspunkt gehostet wurden.
Hinweis
Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>
B. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Upgrade eines freigegebenen Verteilungspunkts
Der erste Befehl ruft das Verteilungspunktobjekt mit der ID 6617708D-0F98-4898-8D05-9E882C23DCB2 ab und speichert das Objekt in der variablen $CIObj.
Der zweite Befehl aktualisiert den in $CIObj gespeicherten freigegebenen Verteilungspunkt auf den Configuration Manager Standort mit dem Standortcode CM1. Der Befehl gibt den Importpfad für das von der PKI ausgestellte Zertifikat an, das vom Verteilungspunkt verwendet wird, und gibt an, dass der Verteilungspunkt Inhalte vorstufen kann.
$CIObj = Get-CMDistributionPoint -DistributionPointGroupId "{6617708D-0F98-4898-8D05-9E882C23DCB2}"
Start-CMDistributionPointUpgrade -AllowPreStaging $True -CertificatePath "\\Contoso01\CM\Toolbox\BaseCert.txt" -SharedDistributionPoint $CIObj -SiteCode "CM1"
Parameter
-AllowFallbackForContent
Gibt an, ob Clients einen Fallbackquellspeicherort für Inhalte verwenden können.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowPreStaging
Gibt an, ob der Verteilungspunkt Inhalte vorstufen kann.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRespondIncomingPxeRequest
Gibt an, ob der Verteilungspunkt auf PXE-Anforderungen (Pre-Boot Execution Environment) reagieren kann.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateExpirationTimeUtc
Gibt das Datum und die Uhrzeit des Ablaufs des Zertifikats an.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificatePassword
Gibt das Kennwort als sichere Zeichenfolge für das PKI-Clientzertifikat (Public Key Infrastructure) für den Verteilungspunkt an.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificatePath
Gibt den Importpfad für das von der PKI ausgestellte Zertifikat an, das vom Verteilungspunkt verwendet wird.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClientCommunicationMode
Type: | ComputerCommunicationType |
Accepted values: | Http, Https |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClientConnectionType
Gibt den Clientverbindungstyp an. Gültige Werte sind:
- Internet
- InternetAndIntranet
- Intranet
Type: | ClientConnectionTypes |
Accepted values: | Intranet, Internet, InternetAndIntranet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentValidationPriority
Gibt die Priorität der Inhaltsüberprüfung an. Gültige Werte sind:
- Hoch
- Highest
- Niedrig
- Lowest
- Mittel
Der Standardwert ist Niedrigste.
Type: | Priority |
Accepted values: | Lowest, Low, Medium, High, Highest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationSiteCode
Type: | String |
Aliases: | SiteCode |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAnonymous
Gibt an, ob der Verteilungspunkt anonyme Verbindungen zwischen Configuration Manager Clients und der Inhaltsbibliothek zulässt.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableNonWdsPxe
Gibt an, ob der Configuration Manager PXE-Antwortdienst auf dem Verteilungspunkt aktiviert ist. Wenn Sie einen PXE-Antwortdienst ohne Windows-Bereitstellungsdienst (Windows Deployment Service, WDS) aktivieren, installiert Configuration Manager seinen PXE-Antwortdienst auf dem Verteilungspunkt.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnablePxeSupport
Gibt an, ob PXE auf dem Verteilungspunkt aktiviert werden soll.
Wenn Sie PXE aktivieren, installiert Configuration Manager bei Bedarf Die Windows-Bereitstellungsdienste auf dem Server. Der Windows-Bereitstellungsdienst ist der Dienst, der den PXE-Start ausführt, um Betriebssysteme zu installieren. Nachdem Sie den Verteilungspunkt erstellt haben, installiert Configuration Manager einen Anbieter in den Windows-Bereitstellungsdiensten, der die PXE-Startfunktionen verwendet.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableUnknownComputerSupport
Gibt an, ob die Unterstützung für unbekannte Computer aktiviert ist. Unbekannte Computer sind Computer, die nicht von Configuration Manager verwaltet werden.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWhenDuplicateCertificate
Gibt an, ob Configuration Manager beim Importieren eines PKI-Clientzertifikats für den Verteilungspunkt ein doppeltes Zertifikat überschreibt.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InitiateConnection
Gibt an, ob der Verteilungspunkt die Verbindung mit den Clients initiiert.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Type: | IResultObject |
Aliases: | SharedDistributionPoint |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstallationAccount
Gibt ein Standortsysteminstallationskonto an. Configuration Manager 2007 Standortkomponenten-Manager-Dienst verwendet Standortsysteminstallationskonten, um Standortsysteme zu installieren, neu zu installieren, zu deinstallieren und zu konfigurieren.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallIis
Type: | Boolean |
Aliases: | InstallInternetServer |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MacAddressForRespondingPxeRequest
Gibt ein Array von MAC-Adressen (Media Access Controller) an, die der Verteilungspunkt verwendet, um auf PXE-Anforderungen (Pre-Boot Execution Environment) zu reagieren.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinFreeSpaceMB
Gibt die Menge an freiem Speicherplatz auf einem Laufwerk an, bevor Configuration Manager ein anderes Laufwerk wählt und den Kopiervorgang auf dieses Laufwerk fortsetzt. Inhaltsdateien können mehrere Laufwerke umfassen.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PathForSavingMigratedPackage
Gibt den Pfad für eine Kopie des migrierten Inhalts an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrimaryContentLibraryLocation
Gibt den primären Inhaltsspeicherort an. Configuration Manager Inhalt an den primären Inhaltsspeicherort kopiert, bis die Menge des freien Speicherplatzes den Wert erreicht, den Sie für den MinFreeSpaceMB-Parameter angegeben haben. Gültige Werte sind:
- Automatisch.
- Laufwerkbuchstabe von A: bis Z:.
Type: | DriveType |
Accepted values: | Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrimaryPackageShareLocation
Gibt den speicherort der primären Paketfreigabe an. Configuration Manager Inhalt in den primären Paketfreigabespeicherort kopiert, bis die Menge des freien Speicherplatzes den Wert erreicht, den Sie für den MinFreeSpaceMB-Parameter angegeben haben. Gültige Werte sind:
- Automatisch.
- Laufwerkbuchstabe von A: bis Z:.
Type: | DriveType |
Accepted values: | Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicFqdn
Gibt den vollqualifizierten Domänennamen (FQDN) des Standortsystemservers an, auf dem der Verteilungspunkt gehostet wird.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PxePassword
Type: | SecureString |
Aliases: | ComputersUsePxePassword |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PxeServerResponseDelaySec
Type: | Int32 |
Aliases: | PxeServerResponseDelaySeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondaryContentLibraryLocation
Gibt den sekundären Inhaltsspeicherort an. Gültige Werte sind:
- Automatisch.
- Laufwerkbuchstabe von A: bis Z:.
Type: | DriveType |
Accepted values: | Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondaryPackageShareLocation
Gibt den Speicherort der sekundären Paketfreigabe an. Gültige Werte sind:
- Automatisch.
- Laufwerkbuchstabe von A: bis Z:.
Type: | DriveType |
Accepted values: | Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserDeviceAffinity
Geben Sie an, wie der Verteilungspunkt Benutzer dem Zielcomputer für PXE-Bereitstellungen zuordnet. Gültige Werte sind:
- AllowWithAutomaticApproval
- AllowWithManualApproval
- DoNotUse
Type: | UserDeviceAffinityType |
Accepted values: | DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValidateContentSchedule
Gibt ein CMSchedule-Objekt an. Ein CMSchedule-Objekt definiert den Zeitplan für die Überprüfung der Integrität von Inhaltsdateien auf dem Verteilungspunkt. Verwenden Sie zum Erstellen eines CMSchedule-Objekts das Cmdlet New-CMSchedule .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für