Start-CMDistributionPointUpgrade
Met à niveau un point de distribution partagé.
Syntaxe
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>] Description
L’applet de commande Start-CMDistributionPointUpgrade met à niveau un point de distribution partagé vers un point de distribution Configuration Manager.
Lorsque vous migrez à partir d’une hiérarchie source Configuration Manager 2007, vous pouvez mettre à niveau un point de distribution partagé pour en faire un point de distribution Configuration Manager. Vous pouvez mettre à niveau les points de distribution sur les sites principaux et secondaires. Le processus de mise à niveau supprime le point de distribution de la hiérarchie Configuration Manager 2007 et en fait un serveur de système de site dans la hiérarchie Configuration Manager. Ce processus copie également le contenu existant qui se trouve sur le point de distribution vers un nouvel emplacement sur l’ordinateur du point de distribution. Le processus de mise à niveau modifie ensuite la copie du contenu pour créer le magasin d’instances uniques Configuration Manager à utiliser avec le déploiement de contenu Configuration Manager. Par conséquent, lorsque vous mettez à niveau un point de distribution, vous n’avez pas besoin de redistribuer le contenu migré qui a été hébergé sur le point de distribution Configuration Manager 2007.
Remarque
Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1 : Mettre à niveau un point de distribution partagé
La première commande obtient l’objet de point de distribution qui a l’ID 6617708D-0F98-4898-8D05-9E882C23DCB2 et stocke l’objet dans la variable $CIObj.
La deuxième commande met à niveau le point de distribution partagé stocké dans $CIObj vers le site Configuration Manager qui a le code de site CM1. La commande spécifie le chemin d’importation du certificat émis par l’infrastructure à clé publique que le point de distribution utilise, et spécifie que le point de distribution peut préphaser le contenu.
$CIObj = Get-CMDistributionPoint -DistributionPointGroupId "{6617708D-0F98-4898-8D05-9E882C23DCB2}"
Start-CMDistributionPointUpgrade -AllowPreStaging $True -CertificatePath "\\Contoso01\CM\Toolbox\BaseCert.txt" -SharedDistributionPoint $CIObj -SiteCode "CM1"Paramètres
-AllowFallbackForContent
Indique si les clients peuvent utiliser un emplacement source de secours pour le contenu.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AllowPreStaging
Indique si le point de distribution peut préphaser le contenu.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AllowRespondIncomingPxeRequest
Indique si le point de distribution peut répondre aux requêtes PXE (Pre-Boot Execution Environment).
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CertificateExpirationTimeUtc
Spécifie la date et l’heure d’expiration du certificat.
| Type: | DateTime |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CertificatePassword
Spécifie le mot de passe, sous forme de chaîne sécurisée, pour le certificat client d’infrastructure à clé publique (PKI) pour le point de distribution.
| Type: | SecureString |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CertificatePath
Spécifie le chemin d’importation du certificat émis par l’infrastructure à clé publique que le point de distribution utilise.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ClientCommunicationMode
| Type: | ComputerCommunicationType |
| Valeurs acceptées: | Http, Https |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ClientConnectionType
Spécifie le type de connexion client. Les valeurs valides sont les suivantes :
- Internet
- InternetAndIntranet
- Intranet
| Type: | ClientConnectionTypes |
| Valeurs acceptées: | Intranet, Internet, InternetAndIntranet |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ContentValidationPriority
Spécifie la priorité de validation du contenu. Les valeurs valides sont les suivantes :
- Élevé
- La plus élevée
- Faible
- La plus faible
- Moyen
La valeur par défaut est La plus basse.
| Type: | Priority |
| Valeurs acceptées: | Lowest, Low, Medium, High, Highest |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DestinationSiteCode
| Type: | String |
| Alias: | SiteCode |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-EnableAnonymous
Indique si le point de distribution autorise les connexions anonymes entre les clients Configuration Manager et la bibliothèque de contenu.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-EnableNonWdsPxe
Indique si le répondeur PXE configuration Manager est activé sur le point de distribution. Lorsque vous activez un répondeur PXE sans le service de déploiement Windows (WDS), Configuration Manager installe son service de répondeur PXE sur le point de distribution.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-EnablePxeSupport
Indique s’il faut activer PXE sur le point de distribution.
Lorsque vous activez PXE, Configuration Manager installe les services de déploiement Windows sur le serveur, si nécessaire. Le service de déploiement Windows est le service qui effectue le démarrage PXE pour installer les systèmes d’exploitation. Après avoir créé le point de distribution, Configuration Manager installe un fournisseur dans les services de déploiement Windows qui utilise les fonctions de démarrage PXE.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-EnableUnknownComputerSupport
Indique si la prise en charge des ordinateurs inconnus est activée. Les ordinateurs inconnus sont des ordinateurs qui ne sont pas gérés par Configuration Manager.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ForceWhenDuplicateCertificate
Indique si Configuration Manager remplace un certificat en double lorsque vous importez un certificat client PKI pour le point de distribution.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ForceWildcardHandling
Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InitiateConnection
Indique si le point de distribution lance la connexion avec les clients.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InputObject
| Type: | IResultObject |
| Alias: | SharedDistributionPoint |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-InstallationAccount
Spécifie un compte d’installation de système de site. Le service Gestionnaire de composants de site Configuration Manager 2007 utilise des comptes d’installation de système de site pour installer, réinstaller, désinstaller et configurer des systèmes de site.
| Type: | IResultObject |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InstallIis
| Type: | Boolean |
| Alias: | InstallInternetServer |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-MacAddressForRespondingPxeRequest
Spécifie un tableau d’adresses MAC (Media Access Controller) que le point de distribution utilise pour répondre aux requêtes PXE (pre-boot execution environment).
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-MinFreeSpaceMB
Spécifie la quantité d’espace libre sur un lecteur avant que Configuration Manager ne choisisse un autre lecteur et poursuive le processus de copie sur ce lecteur. Les fichiers de contenu peuvent s’étendre sur plusieurs lecteurs.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PathForSavingMigratedPackage
Spécifie le chemin d’accès d’une copie du contenu migré.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PrimaryContentLibraryLocation
Spécifie l’emplacement de contenu principal. Configuration Manager copie le contenu vers l’emplacement de contenu principal jusqu’à ce que la quantité d’espace libre atteigne la valeur que vous avez spécifiée pour le paramètre MinFreeSpaceMB . Les valeurs valides sont les suivantes :
- Automatique.
- Lettre de lecteur de A : à Z :.
| Type: | DriveType |
| Valeurs acceptées: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PrimaryPackageShareLocation
Spécifie l’emplacement du partage de package principal. Configuration Manager copie le contenu vers l’emplacement de partage de package principal jusqu’à ce que la quantité d’espace libre atteigne la valeur que vous avez spécifiée pour le paramètre MinFreeSpaceMB . Les valeurs valides sont les suivantes :
- Automatique.
- Lettre de lecteur de A : à Z :.
| Type: | DriveType |
| Valeurs acceptées: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PublicFqdn
Spécifie le nom de domaine complet (FQDN) du serveur de système de site qui héberge le point de distribution.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PxePassword
| Type: | SecureString |
| Alias: | ComputersUsePxePassword |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PxeServerResponseDelaySec
| Type: | Int32 |
| Alias: | PxeServerResponseDelaySeconds |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SecondaryContentLibraryLocation
Spécifie l’emplacement du contenu secondaire. Les valeurs valides sont les suivantes :
- Automatique.
- Lettre de lecteur de A : à Z :.
| Type: | DriveType |
| Valeurs acceptées: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SecondaryPackageShareLocation
Spécifie l’emplacement du partage de package secondaire. Les valeurs valides sont les suivantes :
- Automatique.
- Lettre de lecteur de A : à Z :.
| Type: | DriveType |
| Valeurs acceptées: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UserDeviceAffinity
Spécifiez comment le point de distribution associe les utilisateurs à l’ordinateur de destination pour les déploiements PXE. Les valeurs valides sont les suivantes :
- AllowWithAutomaticApproval
- AllowWithManualApproval
- DoNotUse
| Type: | UserDeviceAffinityType |
| Valeurs acceptées: | DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ValidateContentSchedule
Spécifie un objet CMSchedule. Un objet CMSchedule définit la planification de validation de l’intégrité des fichiers de contenu sur le point de distribution. Pour créer un objet CMSchedule, utilisez l’applet de commande New-CMSchedule .
| Type: | IResultObject |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject