Update-AzStorageMoverAgent
Creates or updates an Agent resource.
Syntax
Update-AzStorageMoverAgent
-Name <String>
-ResourceGroupName <String>
-StorageMoverName <String>
[-SubscriptionId <String>]
[-Description <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzStorageMoverAgent
-Name <String>
-ResourceGroupName <String>
-StorageMoverName <String>
[-SubscriptionId <String>]
-Agent <IAgentUpdateParameters>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzStorageMoverAgent
-InputObject <IStorageMoverIdentity>
[-Description <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzStorageMoverAgent
-InputObject <IStorageMoverIdentity>
-Agent <IAgentUpdateParameters>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Creates or updates an Agent resource.
Examples
Example 1: Update an agent.
Update-AzStorageMoverAgent -ResourceGroupName myResourceGroup -StorageMoverName myStorageMover -Name myAgent -Description "Update description"
AgentStatus : Registering
ArcResourceId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myAgent
ArcVMUuid : aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
Description : Update description
ErrorDetailCode :
ErrorDetailMessage :
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/microsoft.storagemover/storagemovers/myStorageMover/agents/myAgent
LastStatusUpdate :
LocalIPAddress :
MemoryInMb :
Name : myAgent
NumberOfCores :
ProvisioningState : Succeeded
SystemDataCreatedAt : 8/2/2022 7:15:19 AM
SystemDataCreatedBy : myAccount@xxx.com
SystemDataCreatedByType : User
SystemDataLastModifiedAt : 8/2/2022 7:15:19 AM
SystemDataLastModifiedBy : myAccount@xxx.com
SystemDataLastModifiedByType : User
Type : microsoft.storagemover/storagemovers/agents
UptimeInSeconds :
Version :
This command updates the description of a Storage mover agent.
Parameters
-Agent
The Agent resource. To construct, see NOTES section for AGENT properties and create a hash table.
Type: | IAgentUpdateParameters |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
A description for the Agent.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
Type: | IStorageMoverIdentity |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
The name of the Agent resource.
Type: | String |
Aliases: | AgentName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
The name of the resource group. The name is case insensitive.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StorageMoverName
The name of the Storage Mover resource.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
The ID of the target subscription.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |