Set-CMStateMigrationPoint
Modifie les paramètres d’un point de migration d’état dans Configuration Manager.
Syntaxe
Set-CMStateMigrationPoint
[-AddBoundaryGroupName <String[]>]
[-AddStorageFolder <StorageDirectoryData[]>]
[-AllowFallbackSourceLocationForContent <Boolean>]
[-DeleteImmediately]
[-EnableRestoreOnlyMode <Boolean>]
-InputObject <IResultObject>
[-PassThru]
[-RemoveBoundaryGroupName <String[]>]
[-RemoveStorageFolder <StorageDirectoryData[]>]
[-TimeDeleteAfter <Int32>]
[-TimeUnit <IntervalType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMStateMigrationPoint
[-AddBoundaryGroupName <String[]>]
[-AddStorageFolder <StorageDirectoryData[]>]
[-AllowFallbackSourceLocationForContent <Boolean>]
[-DeleteImmediately]
[-EnableRestoreOnlyMode <Boolean>]
[-PassThru]
[-RemoveBoundaryGroupName <String[]>]
[-RemoveStorageFolder <StorageDirectoryData[]>]
[-SiteCode <String>]
[-SiteSystemServerName] <String>
[-TimeDeleteAfter <Int32>]
[-TimeUnit <IntervalType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Set-CMStateMigrationPoint modifie les paramètres d’un point de migration d’état dans Configuration Manager. Un point de migration d’état est un rôle de système de site qui gère le transfert de données à partir des ordinateurs clients pendant un processus d’installation du système d’exploitation. Utilisez cette applet de commande pour modifier les groupes de limites et les dossiers de stockage associés au point de migration, le délai d’attente avant que le point de migration supprime les données clientes, s’il faut autoriser un emplacement source de secours pour le contenu et s’il faut activer le mode restauration uniquement.
Vous pouvez spécifier le point de migration à modifier à l’aide du nom du serveur de système de site et du code de site, ou utiliser l’applet de commande Get-CMStateMigrationPoint .
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 : Modifier un point de migration d’état
PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit HoursCet exemple modifie un point de migration nommé MigrationServer.TSQA.Contoso.com pour le site qui a le code CM4. L’exemple modifie le point de migration pour autoriser un emplacement source de secours pour le contenu et modifie la durée après le téléchargement des données pour supprimer les données.
La première commande utilise l’applet de commande Get-CMStateMigrationPoint pour obtenir un point de migration pour le code de site et le nom de serveur spécifiés, et le stocke dans la variable $StateMigrationPoint.
La deuxième commande modifie l’objet d’entrée stocké dans la variable $StateMigrationPoint. La commande définit le paramètre AllowFallbackSourceLocationForContent sur $True et modifie la durée de suppression après à 12 heures.
Exemple 2 : Modifier des dossiers de stockage et des groupes de limites pour un point de migration d’état
PS XYZ:\> $Storage01 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte -StorageFolderName "C:\"
PS XYZ:\> $Storage02 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit Gigabyte -StorageFolderName "D:\"
PS XYZ:\> Set-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com" -AddBoundaryGroupName "BG07" -AddStorageFolder $Storage02 -AllowFallbackSourceLocationForContent $False -DeleteImmediately -EnableRestoreOnlyMode $True -RemoveBoundaryGroupName "BG22" -RemoveStorageFolder $Storage01Cet exemple modifie les paramètres d’un point de migration d’état nommé MigrationServer.TSQA.Contoso.com pour le site dont le code de site est CM4. L’exemple remplace un autre groupe de limites et un autre dossier de stockage, et modifie d’autres paramètres.
La première commande utilise l’applet de commande New-CMStoragefolder pour créer un objet de dossier de stockage et le stocke dans la variable $Storage 01. Pour plus d’informations, consultez la documentation relative à cette applet de commande.
La deuxième commande utilise l’applet de commande New-CMStoragefolder pour créer un objet de dossier de stockage et le stocke dans la variable $Storage 02.
La troisième commande supprime le dossier de stockage stocké dans la variable $Storage 01 du point de migration et, dans la même commande, ajoute le dossier de stockage stocké dans la variable $Storage 02 au point de migration. De même, la commande supprime le groupe de limites nommé BG22 et ajoute le groupe de limites nommé BG07. La commande spécifie également une valeur de $False pour le paramètre AllowFallbackSourceLocationForContent et une valeur de $True pour le paramètre EnableRestoreOnlyMode . La commande utilise le paramètre DeleteImmediately ; par conséquent, le point de migration supprime les informations client immédiatement après le téléchargement.
Paramètres
-AddBoundaryGroupName
Spécifie un tableau de noms de groupes de limites. L’applet de commande ajoute ces groupes de limites au point de migration d’état. Pendant la migration, les clients d’un groupe de limites utilisent ce site comme emplacement source pour le contenu.
| 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 |
-AddStorageFolder
Spécifie un tableau de dossiers de stockage, en tant qu’objets de données de répertoire de stockage. L’applet de commande ajoute ces dossiers au point de migration d’état. Pour obtenir un objet de données de répertoire de stockage, utilisez l’applet de commande New-CMStoragefolder .
Un point de migration d’état stocke les données d’état utilisateur lorsqu’il migre un ordinateur vers un nouveau système d’exploitation.
| Type: | StorageDirectoryData[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AllowFallbackSourceLocationForContent
Indique si un emplacement source de secours est disponible.
| 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 |
-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 |
-DeleteImmediately
Indique que la suppression des données client se produit immédiatement après le téléchargement de ces données par l’ordinateur cible. Si vous sélectionnez une valeur de $False, spécifiez la durée d’attente à l’aide des paramètres TimeDeleteAfter et TimeUnit .
| 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 |
-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 |
-EnableRestoreOnlyMode
Indique s’il faut activer le mode restauration uniquement. En mode restauration uniquement, Configuration Manager refuse les nouvelles demandes de stockage des données client.
| 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 |
-InputObject
Spécifie un objet point de migration d’état. Pour obtenir un objet point de migration d’état, utilisez l’applet de commande Get-CMStateMigrationPoint .
| Type: | IResultObject |
| Alias: | StateMigrationPoint |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-PassThru
Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.
| 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 |
-RemoveBoundaryGroupName
Spécifie un tableau de noms de groupes de limites. L’applet de commande supprime ces groupes de limites du point de migration d’état. Pendant la migration, les clients d’un groupe de limites utilisent ce site comme emplacement source pour le contenu.
| 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 |
-RemoveStorageFolder
Spécifie un tableau de dossiers de stockage, en tant qu’objets de données de répertoire de stockage. L’applet de commande supprime ces dossiers du point de migration d’état. Un point de migration d’état stocke les données d’état utilisateur lorsqu’il migre un ordinateur vers un nouveau système d’exploitation.
| Type: | StorageDirectoryData[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SiteCode
Spécifie le code de site pour un site Configuration Manager.
| 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 |
-SiteSystemServerName
Spécifie le nom d’hôte d’un point de migration d’état.
| Type: | String |
| Alias: | Name, ServerName |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TimeDeleteAfter
Spécifie le délai d’attente après que l’ordinateur cible a téléchargé les données pour supprimer ces données. Spécifiez une unité de temps à l’aide du paramètre TimeUnit . Pour supprimer des données immédiatement, spécifiez la valeur $True pour le paramètre DeleteImmediately .
| 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 |
-TimeUnit
Spécifie une unité de temps pour la valeur spécifiée dans le paramètre TimeDeleteAfter . Les valeurs acceptables pour ce paramètre sont : Jours et Heures.
| Type: | IntervalType |
| Valeurs acceptées: | Hours, Days |
| 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
Sorties
IResultObject