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

Get-AzCloudServiceRoleInstance

从云服务获取角色实例。

语法

Get-AzCloudServiceRoleInstance
   -CloudServiceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String[]>]
   [-Expand <InstanceViewTypes>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzCloudServiceRoleInstance
   -CloudServiceName <String>
   -ResourceGroupName <String>
   -RoleInstanceName <String>
   [-SubscriptionId <String[]>]
   [-Expand <InstanceViewTypes>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzCloudServiceRoleInstance
   -InputObject <ICloudServiceIdentity>
   [-Expand <InstanceViewTypes>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

说明

从云服务获取角色实例。

示例

示例 1:获取所有角色实例

Get-AzCloudServiceRoleInstance -ResourceGroupName "ContosOrg" -CloudServiceName "ContosoCS"

Name                    Location    SkuName        SkuTier
----                    --------    -------        -------
ContosoFrontEnd_IN_0    eastus2euap Standard_D1_v2 Standard
ContosoFrontEnd_IN_1    eastus2euap Standard_D1_v2 Standard
ContosoBackEnd_IN_1     eastus2euap Standard_D1_v2 Standard
ContosoBackEnd_IN_1     eastus2euap Standard_D1_v2 Standard

此命令获取属于名为 ContosOrg 的资源组的云服务的所有角色实例的属性。

示例 2:获取单个角色实例的属性

Get-AzCloudServiceRoleInstance -ResourceGroupName "ContosOrg" -CloudServiceName "ContosoCS" -RoleInstanceName "ContosoFrontEnd_IN_0"

Name                    Location    SkuName        SkuTier
----                    --------    -------        -------
ContosoFrontEnd_IN_0    eastus2euap Standard_D1_v2 Standard

此命令获取名为 ContosoCS 的云服务ContosoFrontEnd_IN_0的角色实例的属性,该实例属于名为 ContosOrg 的资源组。

参数

-CloudServiceName

云服务的名称。

Type:String
Position:Named
Default value:None
Required:True
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

-Expand

要应用于操作的展开表达式。 云服务不支持“UserData”。

Type:InstanceViewTypes
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

-ResourceGroupName

资源组的名称。

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

-RoleInstanceName

角色实例的名称。

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

输入

ICloudServiceIdentity

输出

IRoleInstance

备注

别名

复杂参数属性

若要创建下面所述的参数,请构造一个包含相应属性的哈希表。 有关哈希表的信息,请运行 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,依如此。