你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Update-AzStorageMoverAgent

Creates or updates an Agent resource.

Syntax

Update-AzStorageMoverAgent
      -Name <String>
      -ResourceGroupName <String>
      -StorageMoverName <String>
      [-SubscriptionId <String>]
      [-Description <String>]
      [-UploadLimitScheduleWeeklyRecurrence <IUploadLimitWeeklyRecurrence[]>]
      [-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>]
      [-UploadLimitScheduleWeeklyRecurrence <IUploadLimitWeeklyRecurrence[]>]
      [-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

$recurrence = New-AzStorageMoverUploadLimitWeeklyRecurrenceObject -Day 'Monday','Tuesday','Friday' -LimitInMbps 100 -EndTimeHour 5 -StartTimeHour 1 -StartTimeMinute 30 -EndTimeMinute 0
Update-AzStorageMoverAgent -ResourceGroupName myresourcegroup -StorageMoverName mystoragemover -Name myagent -Description "Update description" -UploadLimitScheduleWeeklyRecurrence $recurrence

AgentStatus                         : Online
ArcResourceId                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.HybridCompute/machines/myagent
ArcVMUuid                           : 00000000-0000-0000-0000-000000000000
Description                         : Update description
ErrorDetailCode                     :
ErrorDetailMessage                  :
Id                                  : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.StorageMover/storageMovers/mystoragemover/agents/myagent
LastStatusUpdate                    : 6/12/2024 5:57:45 AM
LocalIPAddress                      : 000.000.000.00
MemoryInMb                          : 1470
Name                                : myagent
NumberOfCores                       : 8
ProvisioningState                   : Succeeded
SystemDataCreatedAt                 : 6/12/2024 5:47:26 AM
SystemDataCreatedBy                 : example@microsoft.com
SystemDataCreatedByType             : User
SystemDataLastModifiedAt            : 6/12/2024 5:57:54 AM
SystemDataLastModifiedBy            : example@microsoft.com
SystemDataLastModifiedByType        : User
TimeZone                            : UTC
Type                                : microsoft.storagemover/storagemovers/agents
UploadLimitScheduleWeeklyRecurrence : {{
                                        "startTime": {
                                          "hour": 1,
                                          "minute": 30
                                        },
                                        "endTime": {
                                          "hour": 5,
                                          "minute": 0
                                        },
                                        "days": [ "Monday", "Tuesday", "Friday" ],
                                        "limitInMbps": 100
                                      }}
UptimeInSeconds                     : 3417
Version                             :

This command updates the description and the upload limit weekly recurrence of an 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

-UploadLimitScheduleWeeklyRecurrence

The set of weekly repeating recurrences of the WAN-link upload limit schedule. To construct, see NOTES section for UPLOADLIMITSCHEDULEWEEKLYRECURRENCE properties and create a hash table.

Type:IUploadLimitWeeklyRecurrence[]
Position:Named
Default value:None
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

Inputs

IAgentUpdateParameters

IStorageMoverIdentity

Outputs

IAgent