Set-CMStateMigrationPoint
SYNOPSIS
Ändrar inställningarna för en plats för tillståndsmigrering i Konfigurationshanteraren.
SYNTAX
SetByValue (standard)
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
Cmdleten Set-CMStateMigrationPoint ändrar inställningarna för en tillståndsmigreringsplats i Konfigurationshanteraren. En tillståndsmigreringsplats är en platssystemroll som hanterar dataöverföring från klientdatorer under en installationsprocess för operativsystemet. Använd den här cmdleten för att ändra gränsgrupper och lagringsmappar som är associerade med migreringsplatsen, hur lång tid som ska vänta innan migreringsplatsen tar bort klientdata, om du vill tillåta en återställningskälla för innehåll och om du vill aktivera läget endast återställning.
Du kan ange vilken migreringsplats som ska ändras med hjälp av platssystemserverns namn och platskoden, eller använda cmdleten Get-CMStateMigrationPoint.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Ändra en tillståndsmigreringsplats
PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit Hours
Det här exemplet ändrar en migreringsplats med MigrationServer.TSQA.Contoso.com för den plats som har koden CM4. Exemplet ändrar migreringsplatsen för att tillåta en återställningsplats för innehåll och ändrar hur lång tid det tar efter datanedladdningen för att ta bort data.
Det första kommandot använder cmdleten Get-CMStateMigrationPoint för att hämta en migreringsplats för den angivna platskoden och servernamnet och lagrar den i $StateMigrationPoint variabeln.
Det andra kommandot ändrar det indataobjekt som lagras i $StateMigrationPoint variabeln. Kommandot anger parametern AllowFallbackSourceLocationForContent till $True och ändrar tiden att ta bort efter till 12 timmar.
Exempel 2: Ändra lagringsmappar och gränsgrupper för en tillståndsmigreringsplats
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
Det här exemplet ändrar inställningarna för en plats för tillståndsmigrering med MigrationServer.TSQA.Contoso.com för den plats som har platskoden CM4. Exemplet ersätter en annan gränsgrupp och en annan lagringsmapp och ändrar andra inställningar.
Det första kommandot använder cmdleten New-CMStoragefolder för att skapa ett lagringsmappobjekt och lagrar det i variabeln $Storage 01. Mer information finns i dokumentationen för denna cmdlet.
Det andra kommandot använder cmdleten New-CMStoragefolder för att skapa ett lagringsmappobjekt och lagrar det i variabeln $Storage 02.
Det tredje kommandot tar bort lagringsmappen som lagras i variabeln $Storage 01 från migreringsplatsen och lägger i samma kommando till lagringsmappen som lagras i variabeln $Storage 02 till migreringsplatsen. På samma sätt tar kommandot bort gränsgruppen med namnet BG22 och lägger till gränsgruppen med namnet BG07. Kommandot anger också värdet $False för parametern AllowFallbackSourceLocationForContent och värdet $True för parametern EnableRestoreOnlyMode. Kommandot använder parametern DeleteImmediately. Därför tar migreringsplatsen bort klientinformation omedelbart efter nedladdningen.
PARAMETERS
-AddBoundaryGroupName
Anger en matris med gränsgruppnamn. Cmdleten lägger till dessa gränsgrupper till tillståndsmigreringsplatsen. Under migreringen använder klienter i en gränsgrupp den här platsen som källplats för innehåll.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddStorageFolder
Anger en matris med lagringsmappar som dataobjekt för lagringskatalogen. Cmdleten lägger till dessa mappar på tillståndsmigreringsplatsen. Om du vill hämta ett dataobjekt för lagringskatalogen använder du cmdleten New-CMStoragefolder.
En tillståndsmigreringsplats lagrar användartillståndsdata när en dator migreras till ett nytt operativsystem.
Type: StorageDirectoryData[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowFallbackSourceLocationForContent
Anger om en återställningskälla är tillgänglig.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeleteImmediately
Anger att borttagning av klientdata sker omedelbart efter att måldatorn har laddat ned dessa data. Om du väljer värdet för $False anger du hur länge du ska vänta med hjälp av parametrarna TimeDeleteAfter och TimeUnit.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableRestoreOnlyMode
Anger om endast återställningsläge ska aktiveras. I läget endast återställning nekar Konfigurationshanteraren nya begäranden för att lagra klientdata.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Anger ett tillståndsmigreringsplatsobjekt. Om du vill hämta ett tillståndsmigreringsplatsobjekt använder du cmdleten 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
Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten kanske inte några utdata.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveBoundaryGroupName
Anger en matris med gränsgruppnamn. Cmdleten tar bort dessa gränsgrupper från tillståndsmigreringsplatsen. Under migreringen använder klienter i en gränsgrupp den här platsen som källplats för innehåll.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveStorageFolder
Anger en matris med lagringsmappar som dataobjekt för lagringskatalogen. Cmdleten tar bort mapparna från tillståndsmigreringsplatsen. En tillståndsmigreringsplats lagrar användartillståndsdata när en dator migreras till ett nytt operativsystem.
Type: StorageDirectoryData[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SiteCode
Anger platskoden för en Konfigurationshanteraren plats.
Type: String
Parameter Sets: SetByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SiteSystemServerName
Anger värdnamnet för en tillståndsmigreringsplats.
Type: String
Parameter Sets: SetByName
Aliases: Name, ServerName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeDeleteAfter
Anger hur lång tid det tar att vänta efter att måldatorn har laddat ned data för att ta bort dessa data. Ange en tidsenhet med hjälp av parametern TimeUnit. Om du vill ta bort data omedelbart anger du värdet $True för parametern DeleteImmediately.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeUnit
Anger en tidsenhet för det värde som anges i parametern TimeDeleteAfter. Godkända värden för den här parametern är: Dagar och timmar.
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
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.