Freigeben über


Invoke-AzResourceMoverPrepare

Initiiert die Vorbereitung auf den Satz von Ressourcen, die im Anforderungstext enthalten sind. Der Vorbereitungsvorgang befindet sich in den moveResources, die sich im moveState "PreparePending" oder "PrepareFailed" befinden, bei einem erfolgreichen Abschluss führen moveResource moveState einen Übergang zu MovePending durch. Um dem Benutzer die Voraussetzung für den Vorgang zu geben, kann der Client den Vorgang aufrufen, wobei "validateOnly"-Eigenschaft auf "true" festgelegt ist.

Der Befehl "Invoke-AzResourceMoverPrepare" gilt nicht für Move Collections mit moveType "RegionToZone", da "Prepare" kein gültiger Vorgang für das Zonenverschiebungsszenario ist.

Syntax

Invoke-AzResourceMoverPrepare
      -MoveCollectionName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -MoveResource <String[]>
      [-MoveResourceInputType <MoveResourceInputType>]
      [-ValidateOnly]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Initiiert die Vorbereitung auf den Satz von Ressourcen, die im Anforderungstext enthalten sind. Der Vorbereitungsvorgang befindet sich in den moveResources, die sich im moveState "PreparePending" oder "PrepareFailed" befinden, bei einem erfolgreichen Abschluss führen moveResource moveState einen Übergang zu MovePending durch. Um dem Benutzer die Voraussetzung für den Vorgang zu geben, kann der Client den Vorgang aufrufen, wobei "validateOnly"-Eigenschaft auf "true" festgelegt ist.

Der Befehl "Invoke-AzResourceMoverPrepare" gilt nicht für Move Collections mit moveType "RegionToZone", da "Prepare" kein gültiger Vorgang für das Zonenverschiebungsszenario ist.

Beispiele

Beispiel 1: Überprüfen der Abhängigkeiten vor der Vorbereitung der Ressourcen. Rufen Sie die erforderlichen abhängigen Ressourcen ab, die auch vorbereitet werden müssen.

$resp = Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS"  -MoveResource $('psdemovm') -ValidateOnly

AdditionalInfo : {Microsoft.Azure.PowerShell.Cmdlets.ResourceMover.Models.Api20191001Preview.OperationErrorAdditionalInfo}
Code           : MoveCollectionMissingRequiredDependentResources
Detail         : {}
EndTime        : 2/9/2021 9:04:15 AM
Id             : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/RegionMoveRG-centralus-westcentralus/providers/Microsoft.Migr
                 ate/MoveCollections/PS-centralus-westcentralus-demoRMS/12d055bd-ac52-427f-8b05-b4b21c4b51e8
Message        : The operation has failed as required move resources are missing from the input.
                     Possible Causes: Dependent resources are missing from the input.
                     Recommended Action: Retry the operation with all required resources, if the issue persist contact support.

Name           : 12d055bd-ac52-427f-8b05-b4b21c4b51e8
Property       : Microsoft.Azure.PowerShell.Cmdlets.ResourceMover.Models.Any
StartTime      : 2/9/2021 9:04:14 AM
Status         : Failed

$resp.Code
MoveCollectionMissingRequiredDependentResources

$resp.AdditionalInfo[0].InfoMoveResource

SourceId
--------
/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/psdemorm/providers/microsoft.network/networkinterfaces/psdemovm111     
/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/psdemorm/providers/Microsoft.Network/virtualNetworks/psdemorm-vnet     
/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/psdemorm/providers/microsoft.network/networksecuritygroups/psdemovm-nsg

Überprüfen Sie die Abhängigkeiten vor der Vorbereitung der Ressourcen. Rufen Sie die erforderlichen abhängigen Ressourcen ab, die auch vorbereitet werden müssen.

Beispiel 2: Initiieren der Vorbereitung für den Satz von Ressourcen in der Move-Auflistung mithilfe von "MoveResource Name" als Eingabe.

Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS"  -MoveResource $('PSDemoVM','psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg')

AAdditionalInfo : 
Code           : 
Detail         : 
EndTime        : 2/9/2021 11:25:13 AM
Id             : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/RG-MoveCollection-demoRMS/providers/Microsoft.Migrate/moveCollections/PS-centralus-westcentralus-demoRMS/operations/49e4429
                 4-24ac-4eac-93da-e7e1c815554d
Message        : 
Name           : 49e44294-24ac-4eac-93da-e7e1c815554d
Property       : Microsoft.Azure.PowerShell.Cmdlets.ResourceMover.Models.Any
StartTime      : 2/9/2021 10:55:53 AM
Status         : Succeeded

Initiieren Sie die Vorbereitung für den Satz von Ressourcen in der Move-Auflistung mithilfe von "MoveResource Name" als Eingabe.

Beispiel 3: Initiieren der Vorbereitung für den Satz von Ressourcen in der Move-Auflistung mithilfe von "SourceARMID".

Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -MoveResourceInputType MoveResourceSourceId  -MoveResource $('/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/PSDemoRMS/providers/Microsoft.Network/networkSecurityGroups/PSDemoVM-nsg')

AdditionalInfo :
Code           :
Detail         :
EndTime        : 2/9/2021 11:09:30 AM
Id             : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/RG-MoveCollection-demoRMS/providers/Microsoft.Migrate/MoveColl
                 ections/PS-centralus-westcentralus-demoRMS/operations/c7b13d43-a6fe-48e3-bb8c-3ad9e6ba3355
Message        :
Name           : c7b13d43-a6fe-48e3-bb8c-3ad9e6ba3355
Property       : Microsoft.Azure.PowerShell.Cmdlets.ResourceMover.Models.Any
StartTime      : 2/9/2021 11:05:27 AM
Status         : Succeeded

Initiieren Sie die Vorbereitung für den Satz von Ressourcen in der Move-Auflistung mithilfe von "SourceARMID".

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MoveCollectionName

Der Name der Move-Auflistung.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MoveResource

Ruft die Liste der Ressourcen-IDs ab oder legt sie fest. Standardmäßig akzeptiert sie Verschiebungsressourcen-IDs, es sei denn, der Eingabetyp wird über die moveResourceInputType -Eigenschaft gewechselt.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MoveResourceInputType

Definiert den Eingabetyp der Verschiebungsressource.

Type:MoveResourceInputType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Asynchrones Ausführen des Befehls

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Der Ressourcengruppenname.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Die Abonnement-ID.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValidateOnly

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Vorgang nur vorbedingung ausgeführt werden muss.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

IOperationStatus