你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Register-AzStackHCI
Register-AzStackHCI 创建表示本地群集的 Microsoft.AzureStackHCI 云资源,并将本地群集注册到 Azure。
语法
Register-AzStackHCI
[-SubscriptionId] <String>
[-Region] <String>
[[-ResourceName] <String>]
[[-Tag] <Hashtable>]
[[-TenantId] <String>]
[[-ResourceGroupName] <String>]
[[-ArmAccessToken] <String>]
[[-AccountId] <String>]
[[-EnvironmentName] <String>]
[[-ComputerName] <String>]
[[-CertificateThumbprint] <String>]
[-RepairRegistration]
[-UseDeviceAuthentication]
[[-Credential] <PSCredential>]
[-IsWAC]
[[-ArcServerResourceGroupName] <String>]
[[-ArcSpnCredential] <PSCredential>]
[[-LogsDirectory] <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Register-AzStackHCI 创建表示本地群集的 Microsoft.AzureStackHCI 云资源,并将本地群集注册到 Azure。
示例
示例 1:
Register-AzStackHCI -SubscriptionId "12a0f531-56cb-4340-9501-257726d741fd" -Region "eastus"
Result: Success
ResourceId: /subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCICluster1-rg/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster1
PortalResourceURL: https://portal.azure.com/#@c31c0dbb-ce27-4c78-ad26-a5f717c14557/resource/subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCICluster1-rg/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster1/overview
PortalAADAppPermissionsURL: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/CallAnAPI/appId/980be58d-578c-4cff-b4cd-43e9c3a77826/isMSAApp/
在某个群集节点上调用。
示例 2:
Register-AzStackHCI -SubscriptionId "12a0f531-56cb-4340-9501-257726d741fd" -ComputerName ClusterNode1 -Region "eastus"
Result: Success
ResourceId: /subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCICluster2-rg/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster2
PortalResourceURL: https://portal.azure.com/#@c31c0dbb-ce27-4c78-ad26-a5f717c14557/resource/subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCICluster2-rg/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster2/overview
PortalAADAppPermissionsURL: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/CallAnAPI/appId/950be58d-578c-4cff-b4cd-43e9c3a77866/isMSAApp/
从管理节点调用。
示例 3:
Register-AzStackHCI -SubscriptionId "12a0f531-56cb-4340-9501-257726d741fd" -ArmAccessToken etyer..ere= -AccountId user1@corp1.com -Region westus -ResourceName DemoHCICluster3 -ResourceGroupName DemoHCIRG
Result: PendingForAdminConsent
ResourceId: /subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCIRG/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster3
PortalResourceURL: https://portal.azure.com/#@c31c0dbb-ce27-4c78-ad26-a5f717c14557/resource/subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCIRG/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster3/overview
PortalAADAppPermissionsURL: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/CallAnAPI/appId/980be58d-578c-4cff-b4cd-43e9c3a77866/isMSAApp/
从 WAC 调用。
示例 4:
Register-AzStackHCI -SubscriptionId "12a0f531-56cb-4340-9501-257726d741fd" -Region westus -ResourceName HciCluster1 -TenantId "c31c0dbb-ce27-4c78-ad26-a5f717c14557" -ResourceGroupName HciRG -ArcServerResourceGroupName HciRG -ArmAccessToken eerrer..ere= -AccountId user1@corp1.com -EnvironmentName AzureCloud -ComputerName node1hci -Credential Get-Credential
Result: Success
ResourceId: /subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/HciRG/providers/Microsoft.AzureStackHCI/clusters/HciCluster1
PortalResourceURL: https://portal.azure.com/#@c31c0dbb-ce27-4c78-ad26-a5f717c14557/resource/subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/HciRG/providers/Microsoft.AzureStackHCI/clusters/HciCluster1/overview
PortalAADAppPermissionsURL: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/CallAnAPI/appId/990be58d-578c-4cff-b4cd-43e9c3a77866/isMSAApp/
使用所有参数调用。
参数
-AccountId
指定帐户 ID。指定此 ID 以及 ArmAccessToken 将避免 Azure 交互式登录。
类型: | String |
Position: | 8 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ArcServerResourceGroupName
指定 Arc 资源组名称。 如果未指定,将使用群集资源组名称。
类型: | String |
Position: | 13 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ArcSpnCredential
指定要用于载入 ARC 代理的凭据。 如果未指定,将生成新的凭据集。
类型: | PSCredential |
Position: | 14 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ArmAccessToken
指定 ARM 访问令牌。 指定此项以及 AccountId 将避免 Azure 交互式登录。
类型: | String |
Position: | 7 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-CertificateThumbprint
指定所有节点上可用的证书指纹。 用户负责管理证书。
类型: | String |
Position: | 11 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ComputerName
指定要注册到 Azure 的本地群集中的群集名称或群集节点之一。
类型: | String |
Position: | 10 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Credential
指定 ComputerName 的凭据。 默认值为执行 Cmdlet 的当前用户。
类型: | PSCredential |
Position: | 12 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnvironmentName
指定 Azure 环境。 默认值为 AzureCloud。 有效值为 AzureCloud、AzureChinaCloud、AzurePPE、AzureCanary、AzureUSGovernment
类型: | String |
Position: | 9 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-IsWAC
通过 Windows Admin Center 注册将此参数指定为 true。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-LogsDirectory
指定要保存日志文件的路径。 必须是绝对路径。 默认值为:C:\ProgramData\AzureStackHCI
类型: | String |
Position: | 15 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Region
指定要创建资源的区域。 区域是必需参数。
类型: | String |
Position: | 2 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-RepairRegistration
使用云修复当前的 Azure Stack HCI 注册。 此 cmdlet 删除群集节点上的本地证书和云中 Azure AD 应用程序中的远程证书,并为这两者生成新的替换证书。 将保留资源组、资源名称和其他注册选项。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ResourceGroupName
指定 Azure 资源组名称。 如果未指定 <LocalClusterName>-rg 将用作资源组名称。
类型: | String |
Position: | 6 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ResourceName
指定在 Azure 中创建的资源的资源名称。 如果未指定,则使用本地群集名称。
类型: | String |
Position: | 3 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SubscriptionId
指定要创建资源的 Azure 订阅。 SubscriptionId 是必需参数。
类型: | String |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Tag
以哈希表中键值对的形式指定 Azure 中资源的资源标记。 例如:@{key0=“value0”;key1=$null;key2=“value2”}
类型: | Hashtable |
Position: | 4 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TenantId
指定 Azure TenantId。
类型: | String |
Position: | 5 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-UseDeviceAuthentication
使用设备代码身份验证,而不是交互式浏览器提示。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输出
PSCustomObject. Returns following Properties in PSCustomObject
结果:成功或失败或取消。 ResourceId:在 Azure 中创建的资源的资源 ID。 PortalResourceURL:Azure 门户资源 URL。