Set-CMStateMigrationPoint
SYNOPSIS
Wijzigt instellingen voor een statusmigratiepunt in Configuration Manager.
SYNTAX
SetByValue (standaard)
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>]
SetByName
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
De cmdlet Set-CMStateMigrationPoint wijzigt instellingen voor een statusmigratiepunt in Configuration Manager. Een statusmigratiepunt is een sitesysteemrol die de gegevensoverdracht van clientcomputers beheert tijdens het installatieproces van een besturingssysteem. Gebruik deze cmdlet om de grensgroepen en opslagmappen te wijzigen die aan het migratiepunt zijn gekoppeld, hoe lang moet worden gewacht voordat het migratiepunt clientgegevens verwijdert, of er een terugvalbronlocatie voor inhoud moet worden toegestaan en of de modus Alleen herstellen moet worden ingeschakeld.
U kunt opgeven welk migratiepunt u wilt wijzigen met behulp van de sitesysteemservernaam en de sitecode, of de cmdlet Get-CMStateMigrationPoint gebruiken.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\>
. Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Een statusmigratiepunt wijzigen
PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit Hours
In dit voorbeeld wordt een migratiepunt met de MigrationServer.TSQA.Contoso.com voor de site met de code CM4. In het voorbeeld wordt het migratiepunt gewijzigd om een terugvalbronlocatie voor inhoud toe te staan en wordt gewijzigd hoe lang na het downloaden van gegevens gegevens worden verwijderd.
De eerste opdracht maakt gebruik van de cmdlet Get-CMStateMigrationPoint om een migratiepunt voor de opgegeven sitecode en servernaam op te halen en slaat deze op in de $StateMigrationPoint variabele.
De tweede opdracht wijzigt het invoerobject dat is opgeslagen in de $StateMigrationPoint variabele. Met de opdracht stelt u de parameter AllowFallbackSourceLocationForContent in op $True en wijzigt u de te verwijderen tijd na tot 12 uur.
Voorbeeld 2: opslagmappen en grensgroepen wijzigen voor een statusmigratiepunt
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 $Storage01
In dit voorbeeld worden instellingen voor een statusmigratiepunt met de naam MigrationServer.TSQA.Contoso.com voor de site met de sitecode CM4. In het voorbeeld wordt een andere grensgroep en een andere opslagmap vervangen en worden andere instellingen aangepast.
De eerste opdracht maakt gebruik van de cmdlet New-CMStoragefolder om een opslagmapobject te maken en slaat dit op in de variabele $Storage 01. Raadpleeg de documentatie voor die cmdlet voor meer informatie.
De tweede opdracht maakt gebruik van de cmdlet New-CMStoragefolder om een opslagmapobject te maken en slaat dit op in de variabele $Storage 02.
De derde opdracht verwijdert de opslagmap die is opgeslagen in de variabele $Storage 01 van het migratiepunt en voegt in dezelfde opdracht de opslagmap die is opgeslagen in de variabele $Storage 02 toe aan het migratiepunt. Op dezelfde manier verwijdert u met de opdracht de grensgroep met de naam BG22 en voegt u de grensgroep met de naam BG07 toe. De opdracht geeft ook een waarde van $False voor de parameter AllowFallbackSourceLocationForContent en een waarde van $True voor de parameter EnableRestoreOnlyMode. De opdracht maakt gebruik van de parameter DeleteImmediately; Daarom verwijdert het migratiepunt clientgegevens onmiddellijk na het downloaden.
PARAMETERS
-AddBoundaryGroupName
Hiermee geeft u een matrix met namen van grensgroep. De cmdlet voegt deze grensgroepen toe aan het statusmigratiepunt. Tijdens de migratie gebruiken clients in een grensgroep deze site als bronlocatie voor inhoud.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddStorageFolder
Hiermee geeft u een matrix van opslagmappen op als opslagmapgegevensobjecten. De cmdlet voegt deze mappen toe aan het statusmigratiepunt. Gebruik de cmdlet New-CMStoragefolder om een opslagmapgegevensobject op te halen.
Een statusmigratiepunt slaat gegevens over de gebruikerstoestand op wanneer een computer naar een nieuw besturingssysteem wordt gemigreerd.
Type: StorageDirectoryData[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowFallbackSourceLocationForContent
Geeft aan of een terugvalbronlocatie beschikbaar is.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeleteImmediately
Geeft aan dat de verwijdering van clientgegevens plaatsvindt onmiddellijk nadat de doelcomputer die gegevens downloadt. Als u een waarde van $False selecteert, geeft u op hoe lang moet worden gewacht met behulp van de parameters TimeDeleteAfter en TimeUnit.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableRestoreOnlyMode
Geeft aan of de modus Alleen herstellen moet worden ingeschakeld. In de modus Alleen herstellen worden Configuration Manager nieuwe aanvragen voor het opslaan van clientgegevens geweigerd.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Hiermee geeft u een statusmigratiepuntobject. Als u een statusmigratiepuntobject wilt verkrijgen, gebruikt u de cmdlet Get-CMStateMigrationPoint.
Type: IResultObject
Parameter Sets: SetByValue
Aliases: StateMigrationPoint
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-PassThru
Voeg deze parameter toe om een object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveBoundaryGroupName
Hiermee geeft u een matrix met namen van grensgroep. De cmdlet verwijdert deze grensgroepen van het statusmigratiepunt. Tijdens de migratie gebruiken clients in een grensgroep deze site als bronlocatie voor inhoud.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveStorageFolder
Hiermee geeft u een matrix van opslagmappen op als opslagmapgegevensobjecten. De cmdlet verwijdert deze mappen van het statusmigratiepunt. Een statusmigratiepunt slaat gegevens over de gebruikerstoestand op wanneer een computer naar een nieuw besturingssysteem wordt gemigreerd.
Type: StorageDirectoryData[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SiteCode
Hiermee geeft u de sitecode voor een Configuration Manager site.
Type: String
Parameter Sets: SetByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SiteSystemServerName
Hiermee geeft u de hostnaam voor een statusmigratiepunt.
Type: String
Parameter Sets: SetByName
Aliases: Name, ServerName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeDeleteAfter
Hiermee geeft u de hoeveelheid tijd die moet worden gewacht nadat de doelcomputer gegevens downloadt om die gegevens te verwijderen. Geef een tijdseenheid op met behulp van de parameter TimeUnit. Als u gegevens onmiddellijk wilt verwijderen, geeft u de waarde $True de parameter DeleteImmediately op.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeUnit
Hiermee geeft u een tijdseenheid voor de waarde die is opgegeven in de TimeDeleteAfter parameter. De acceptabele waarden voor deze parameter zijn: Dagen en Uren.
Type: IntervalType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.