Share via

Register-AzStackHCI

  • 참조
모듈:
Az.StackHCI

Register-AzStackHCI는 온-프레미스 클러스터를 나타내는 Microsoft.AzureStackHCI 클라우드 리소스를 만들고 온-프레미스 클러스터를 Azure에 등록합니다.

Syntax

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 대화형 로그온이 방지됩니다.

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

-ArcServerResourceGroupName

Arc 리소스 그룹 이름을 지정합니다. 지정하지 않으면 클러스터 리소스 그룹 이름이 사용됩니다.

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

-ArcSpnCredential

ARC 에이전트 온보딩에 사용할 자격 증명을 지정합니다. 지정하지 않으면 새 자격 증명 집합이 생성됩니다.

Type:PSCredential
Position:14
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ArmAccessToken

ARM 액세스 토큰을 지정합니다. AccountId와 함께 이 로그온을 지정하면 Azure 대화형 로그온이 방지됩니다.

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

-CertificateThumbprint

모든 노드에서 사용할 수 있는 인증서의 지문을 지정합니다. 사용자는 인증서를 관리할 책임이 있습니다.

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

-ComputerName

Azure에 등록되는 온-프레미스 클러스터의 클러스터 이름 또는 클러스터 노드 중 하나를 지정합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-Credential

ComputerName에 대한 자격 증명을 지정합니다. 기본값은 Cmdlet을 실행하는 현재 사용자입니다.

Type:PSCredential
Position:12
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnvironmentName

Azure 환경을 지정합니다. 기본값은 AzureCloud입니다. 유효한 값은 AzureCloud, AzureChinaCloud, AzurePPE, AzureCanary, AzureUSGovernment입니다.

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

-IsWAC

Windows 관리 Center를 통한 등록은 이 매개 변수를 true로 지정합니다.

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

-LogsDirectory

로그 파일을 저장할 경로를 지정합니다. 절대 경로여야 합니다. 기본값은 C:\ProgramData\AzureStackHCI입니다.

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

-Region

리소스를 만들 지역을 지정합니다. 지역은 필수 매개 변수입니다.

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

-RepairRegistration

클라우드를 사용하여 현재 Azure Stack HCI 등록을 복구합니다. 이 cmdlet은 클러스터된 노드의 로컬 인증서와 클라우드의 Azure AD 애플리케이션에 있는 원격 인증서를 삭제하고 둘 다에 대한 새 대체 인증서를 생성합니다. 리소스 그룹, 리소스 이름 및 기타 등록 선택은 유지됩니다.

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

-ResourceGroupName

Azure 리소스 그룹 이름을 지정합니다. 지정 <하지 않으면 LocalClusterName-rg>가 리소스 그룹 이름으로 사용됩니다.

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

-ResourceName

Azure에서 만든 리소스의 리소스 이름을 지정합니다. 지정하지 않으면 온-프레미스 클러스터 이름이 사용됩니다.

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

-SubscriptionId

리소스를 만들 Azure 구독을 지정합니다. SubscriptionId는 필수 매개 변수입니다.

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

-Tag

해시 테이블의 키-값 쌍 형식으로 Azure의 리소스에 대한 리소스 태그를 지정합니다. 예: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Azure TenantId를 지정합니다.

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

-UseDeviceAuthentication

대화형 브라우저 프롬프트 대신 디바이스 코드 인증을 사용합니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

출력

PSCustomObject. Returns following Properties in PSCustomObject

결과: 성공 또는 실패 또는 취소됨 ResourceId: Azure에서 만든 리소스의 리소스 ID입니다. PortalResourceURL: Azure Portal 리소스 URL입니다.