< Back

Move-AzureRmResource

Tue Jan 29, 2019 10:05 pm

NAME Move-AzureRmResource



SYNOPSIS

Moves a resource to a different resource group or subscription.





SYNTAX

Move-AzureRmResource [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] -DestinationResourceGroupName <String>

[-DestinationSubscriptionId <Guid>] [-Force] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [-Pre] -ResourceId <String[]>

[-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The Move-AzureRmResource cmdlet moves existing resources to a different resource group. That resource group can be in a different subscription.





PARAMETERS

-ApiVersion <String>

Specifies the version of the resource provider API to use. If you do not specify a version, this cmdlet uses the latest available version.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DestinationResourceGroupName <String>

Specifies the name of the resource group into which this cmdlet moves resources.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DestinationSubscriptionId <Guid>

Specifies the ID of the subscription into which this cmdlet moves resources .



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Force [<SwitchParameter>]

Forces the command to run without asking for user confirmation.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-InformationAction <ActionPreference>

Specifies how this cmdlet responds to an information event.



The acceptable values for this parameter are:



- Continue



- Ignore



- Inquire



- SilentlyContinue



- Stop



- Suspend



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationVariable <String>

Specifies an information variable.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Pre [<SwitchParameter>]

Indicates that this cmdlet considers pre-release API versions when it automatically determines which version to use.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-ResourceId <String[]>

Specifies an array of IDs of the resources that this cmdlet moves.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName, ByValue)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

String[]

Parameter 'ResourceId' accepts value of type 'String[]' from the pipeline





OUTPUTS

System.Boolean







NOTES









Example 1: Move a resource to a resource group



PS C:\\>$Resource = Get-AzureRmResource -ResourceType "Microsoft.ClassicCompute/storageAccounts" -ResourceName "ContosoStorageAccount"

PS C:\\> Move-AzureRmResource -ResourceId $Resource.ResourceId -DestinationResourceGroupName "ResourceGroup14"



The first command gets a resource named ContosoStorageAccount by using the Get-AzureRmResource cmdlet, and then stores that resource in the

$Resource variable.



The second command moves that resource into the resource group named ResourceGroup14. The command identifies the resource to move by using the

ResourceId property of $Resource.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... rmresource

Find-AzureRmResource

Get-AzureRmResource

New-AzureRmResource

Remove-AzureRmResourceGroup

Set-AzureRmResourceGroup