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/クラスター ノードの 1 つで呼び出す。
例 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 を指定します。これを ArmAccessToken と共に指定すると、Azure 対話型ログオンが回避されます。
| 型: | String |
| 配置: | 8 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ArcServerResourceGroupName
Arc リソース グループ名を指定します。 指定しない場合は、クラスター リソース グループ名が使用されます。
| 型: | String |
| 配置: | 13 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ArcSpnCredential
ARC エージェントのオンボードに使用する資格情報を指定します。 指定しない場合は、新しい資格情報のセットが生成されます。
| 型: | PSCredential |
| 配置: | 14 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ArmAccessToken
ARM アクセス トークンを指定します。 AccountId と共にこれを指定すると、Azure 対話型ログオンは回避されます。
| 型: | String |
| 配置: | 7 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CertificateThumbprint
すべてのノードで使用できる証明書の拇印を指定します。 ユーザーは、証明書の管理を担当します。
| 型: | String |
| 配置: | 11 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ComputerName
Azure に登録されているオンプレミス クラスター内のクラスター名またはクラスター ノードの 1 つを指定します。
| 型: | String |
| 配置: | 10 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
ComputerName の資格情報を指定します。 既定値は、コマンドレットを実行している現在のユーザーです。
| 型: | PSCredential |
| 配置: | 12 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnvironmentName
Azure 環境を指定します。 既定値は AzureCloud です。 有効な値は、AzureCloud、AzureChinaCloud、AzurePPE、AzureCanary、AzureUSGovernment です。
| 型: | String |
| 配置: | 9 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IsWAC
Windows Admin Center を使用した登録では、このパラメーターを true に指定します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LogsDirectory
ログ ファイルを保存するパスを指定します。 絶対パスである必要があります。 既定値は C:\ProgramData\AzureStackHCI です。
| 型: | String |
| 配置: | 15 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Region
リソースを作成するリージョンを指定します。 Region は必須パラメーターです。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RepairRegistration
クラウドに対する現在の Azure Stack HCI 登録を修復します。 このコマンドレットは、クラスター化されたノード上のローカル証明書と、クラウド内の Azure AD アプリケーションのリモート証明書を削除し、両方の新しい置換証明書を生成します。 リソース グループ、リソース名、およびその他の登録の選択肢は保持されます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ResourceGroupName
Azure リソース グループ名を指定します。 <LocalClusterName>-rg を指定しない場合は、リソース グループ名として使用されます。
| 型: | String |
| 配置: | 6 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ResourceName
Azure で作成されたリソースのリソース名を指定します。 指定しない場合は、オンプレミスのクラスター名が使用されます。
| 型: | String |
| 配置: | 3 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SubscriptionId
リソースを作成する Azure サブスクリプションを指定します。 SubscriptionId は必須パラメーターです。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Tag
Azure のリソースのリソース タグを、ハッシュ テーブル内のキーと値のペアの形式で指定します。 例: @{key0="value0";key1=$null;key2="value2"}
| 型: | Hashtable |
| 配置: | 4 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TenantId
Azure TenantId を指定します。
| 型: | String |
| 配置: | 5 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseDeviceAuthentication
対話型ブラウザー プロンプトの代わりにデバイス コード認証を使用します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
出力
PSCustomObject. Returns following Properties in PSCustomObject
結果: 成功または失敗または取り消し。 ResourceId: Azure で作成されたリソースのリソース ID。 PortalResourceURL: Azure Portal リソース URL。
Azure PowerShell