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

Invoke-AzCloudServiceRebuild

重新生成角色实例会在 Web 角色或辅助角色的实例上重新安装操作系统,并初始化它们使用的存储资源。 如果不想初始化存储资源,可以使用“重新映像角色实例”。

注意

这是我们文档的早期版本。 有关最新信息 ,请参阅最新版本

语法

Invoke-AzCloudServiceRebuild
      -CloudServiceName <String>
      -ResourceGroupName <String>
      -RoleInstance <String[]>
      [-SubscriptionId <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Invoke-AzCloudServiceRebuild
      -InputObject <ICloudServiceIdentity>
      -RoleInstance <String[]>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

说明

重新生成角色实例会在 Web 角色或辅助角色的实例上重新安装操作系统,并初始化它们使用的存储资源。 如果不想初始化存储资源,可以使用“重新映像角色实例”。

示例

示例 1:重新生成云服务的角色实例

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

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

示例 2:重新生成云服务的所有角色

Invoke-AzCloudServiceRebuild -ResourceGroupName "ContosOrg" -CloudServiceName "ContosoCS" -RoleInstance "*"

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

参数

-AsJob

以作业身份运行命令

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

-CloudServiceName

云服务的名称。

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

-Confirm

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

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

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

-InputObject

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

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

-NoWait

异步运行命令

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

-PassThru

命令成功时返回 true

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

-ResourceGroupName

资源组的名称。

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

-RoleInstance

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

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

-SubscriptionId

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

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
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,依此类推。