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

Restart-AzCloudService

重启云服务中的一个或多个角色实例。

语法

Restart-AzCloudService
       -Name <String>
       -ResourceGroupName <String>
       -RoleInstance <String[]>
       [-SubscriptionId <String>]
       [-DefaultProfile <PSObject>]
       [-AsJob]
       [-NoWait]
       [-PassThru]
       [-Confirm]
       [-WhatIf]
       [<CommonParameters>]
Restart-AzCloudService
       -InputObject <ICloudServiceIdentity>
       -RoleInstance <String[]>
       [-DefaultProfile <PSObject>]
       [-AsJob]
       [-NoWait]
       [-PassThru]
       [-Confirm]
       [-WhatIf]
       [<CommonParameters>]

说明

重启云服务中的一个或多个角色实例。

示例

示例 1:重启云服务的角色实例

$roleInstances = @("ContosoFrontEnd_IN_0", "ContosoBackEnd_IN_1")
Restart-AzCloudService -ResourceGroupName "ContosOrg" -CloudServiceName "ContosoCS" -RoleInstance $roleInstances

此命令会重启 ContosoCS 资源组中 ContosoCS 云服务的 2 个角色实例(ContosoFrontEnd_IN_0 和 ContosoBackEnd_IN_1)。

示例 2:重启云服务的所有角色

Restart-AzCloudService -ResourceGroupName "ContosOrg" -CloudServiceName "ContosoCS" -RoleInstance "*"

此命令会重启 ContosOrg 资源组中 ContosoCS 云服务的所有角色实例。

参数

-AsJob

以作业身份运行命令

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

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

-InputObject

要构造的标识参数,请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

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

-Name

云服务的名称。

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

-NoWait

异步运行命令

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

-PassThru

当命令成功时返回 true

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

-ResourceGroupName

资源组的名称。

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

-RoleInstance

云服务角色实例名称的列表。 “*”的值表示云服务的所有角色实例。

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

-SubscriptionId

唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

输入

ICloudServiceIdentity

输出

Boolean

备注

别名

复杂参数属性

若要创建下面所述的参数,请构造一个包含相应属性的哈希表。 有关哈希表的信息,请运行 Get-Help about_Hash_Tables。

INPUTOBJECT <ICloudServiceIdentity>:标识参数

  • [CloudServiceName <String>]:云服务的名称。
  • [IPConfigurationName <String>]:IP 配置名称。
  • [Id <String>]:资源标识路径
  • [Location <String>]:OS 版本所涉及的位置的名称。
  • [NetworkInterfaceName <String>]:网络接口的名称。
  • [OSFamilyName <String>]:OS 系列的名称。
  • [OSVersionName <String>]:OS 版本的名称。
  • [PublicIPAddressName <String>]:公共 IP 地址的名称。
  • [ResourceGroupName <String>]:资源组的名称。
  • [RoleInstanceName <String>]:角色实例的名称。
  • [RoleName <String>]:角色的名称。
  • [SubscriptionId <String>]:唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。
  • [UpdateDomain <Int32?>]:指定标识更新域的整数值。 更新域使用从零开始的索引进行标识:第一个更新域的 ID 为 0,第二个更新域的 ID 为 1,依如此。