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>]
Description
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를 지정합니다. 이를 ArmAccessToken과 함께 지정하면 Azure 대화형 로그온이 방지됩니다.
형식: | String |
Position: | 8 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ArcServerResourceGroupName
Arc 리소스 그룹 이름을 지정합니다. 지정하지 않으면 클러스터 리소스 그룹 이름이 사용됩니다.
형식: | String |
Position: | 13 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ArcSpnCredential
ARC 에이전트 온보딩에 사용할 자격 증명을 지정합니다. 지정하지 않으면 새 자격 증명 집합이 생성됩니다.
형식: | PSCredential |
Position: | 14 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ArmAccessToken
ARM 액세스 토큰을 지정합니다. AccountId와 함께 이 로그온을 지정하면 Azure 대화형 로그온이 방지됩니다.
형식: | String |
Position: | 7 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-CertificateThumbprint
모든 노드에서 사용할 수 있는 인증서의 지문을 지정합니다. 사용자는 인증서를 관리할 책임이 있습니다.
형식: | String |
Position: | 11 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ComputerName
Azure에 등록되는 온-프레미스 클러스터의 클러스터 이름 또는 클러스터 노드 중 하나를 지정합니다.
형식: | String |
Position: | 10 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Credential
ComputerName에 대한 자격 증명을 지정합니다. 기본값은 Cmdlet을 실행하는 현재 사용자입니다.
형식: | PSCredential |
Position: | 12 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnvironmentName
Azure 환경을 지정합니다. 기본값은 AzureCloud입니다. 유효한 값은 AzureCloud, AzureChinaCloud, AzurePPE, AzureCanary, AzureUSGovernment입니다.
형식: | String |
Position: | 9 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-IsWAC
Windows Admin Center를 통한 등록은 이 매개 변수를 true로 지정합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-LogsDirectory
로그 파일을 저장할 경로를 지정합니다. 절대 경로여야 합니다. 기본값은 C:\ProgramData\AzureStackHCI입니다.
형식: | String |
Position: | 15 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Region
리소스를 만들 지역을 지정합니다. 지역은 필수 매개 변수입니다.
형식: | String |
Position: | 2 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RepairRegistration
클라우드를 사용하여 현재 Azure Stack HCI 등록을 복구합니다. 이 cmdlet은 클러스터된 노드의 로컬 인증서와 클라우드의 Azure AD 애플리케이션에 있는 원격 인증서를 삭제하고 둘 다에 대한 새 대체 인증서를 생성합니다. 리소스 그룹, 리소스 이름 및 기타 등록 선택은 유지됩니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ResourceGroupName
Azure 리소스 그룹 이름을 지정합니다. LocalClusterName><지정하지 않으면 -rg가 리소스 그룹 이름으로 사용됩니다.
형식: | String |
Position: | 6 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ResourceName
Azure에서 만든 리소스의 리소스 이름을 지정합니다. 지정하지 않으면 온-프레미스 클러스터 이름이 사용됩니다.
형식: | String |
Position: | 3 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SubscriptionId
리소스를 만들 Azure 구독을 지정합니다. SubscriptionId는 필수 매개 변수입니다.
형식: | String |
Position: | 1 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Tag
해시 테이블의 키-값 쌍 형식으로 Azure의 리소스에 대한 리소스 태그를 지정합니다. 예: @{key0="value0"; key1=$null; key2="value2"}
형식: | Hashtable |
Position: | 4 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-TenantId
Azure TenantId를 지정합니다.
형식: | String |
Position: | 5 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-UseDeviceAuthentication
대화형 브라우저 프롬프트 대신 디바이스 코드 인증을 사용합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
출력
PSCustomObject. Returns following Properties in PSCustomObject
결과: 성공 또는 실패 또는 취소됨 ResourceId: Azure에서 만든 리소스의 리소스 ID입니다. PortalResourceURL: Azure Portal 리소스 URL입니다.
Azure PowerShell