Sdílet prostřednictvím

Register-AzStackHCI

  • Reference
Modul:
Az.StackHCI

Register-AzStackHCI vytvoří cloudový prostředek Microsoft.AzureStackHCI představující místní cluster a zaregistruje místní cluster v Azure.

Syntaxe

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 vytvoří cloudový prostředek Microsoft.AzureStackHCI představující místní cluster a zaregistruje místní cluster v Azure.

Příklady

Příklad 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/

Vyvolání na jednom z uzlů clusteru

Příklad 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/

Vyvolání z uzlu správy

Příklad 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/

Vyvolání z WAC

Příklad 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/

Vyvolání se všemi parametry

Parametry

-AccountId

Určuje ID účtu. Zadáním tohoto parametru společně s ArmAccessToken se zabrání interaktivnímu přihlášení k Azure.

Typ:String
Position:8
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ArcServerResourceGroupName

Určuje název skupiny prostředků Arc. Pokud není zadaný, použije se název skupiny prostředků clusteru.

Typ:String
Position:13
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ArcSpnCredential

Určuje přihlašovací údaje, které se mají použít pro onboarding agenta ARC. Pokud nezadáte, vygeneruje se nová sada přihlašovacích údajů.

Typ:PSCredential
Position:14
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ArmAccessToken

Určuje přístupový token ARM. Zadáním tohoto parametru spolu s ID účtu se vyhnete interaktivnímu přihlášení Azure.

Typ:String
Position:7
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CertificateThumbprint

Určuje kryptografický otisk certifikátu, který je k dispozici na všech uzlech. Uživatel zodpovídá za správu certifikátu.

Typ:String
Position:11
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ComputerName

Určuje název clusteru nebo jeden z uzlů clusteru v místním clusteru, který je zaregistrovaný v Azure.

Typ:String
Position:10
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje přihlašovací údaje pro Názevpočítače. Výchozí hodnota je aktuální uživatel, který spouští rutinu.

Typ:PSCredential
Position:12
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnvironmentName

Určuje prostředí Azure. Výchozí hodnota je AzureCloud. Platné hodnoty jsou AzureCloud, AzureChinaCloud, AzurePPE, AzureCanary, AzureUSGovernment.

Typ:String
Position:9
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IsWAC

Registrace prostřednictvím centra Windows Admin Center určuje tento parametr na hodnotu true.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LogsDirectory

Určuje cestu, kam se mají ukládat soubory protokolu. Musí to být absolutní cesta. Výchozí hodnota by byla: C:\ProgramData\AzureStackHCI

Typ:String
Position:15
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Region

Určuje oblast, do které se má prostředek vytvořit. Oblast je povinný parametr.

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RepairRegistration

Opravte aktuální registraci Azure Stack HCI v cloudu. Tato rutina odstraní místní certifikáty v clusterovaných uzlech a vzdálených certifikátech v aplikaci Azure AD v cloudu a vygeneruje nové náhradní certifikáty pro obojí. Skupina prostředků, název prostředku a další možnosti registrace se zachovají.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků Azure. Pokud nezadáte <LocalClusterName>-rg, použije se jako název skupiny prostředků.

Typ:String
Position:6
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceName

Určuje název prostředku vytvořeného v Azure. Pokud není zadaný, použije se název místního clusteru.

Typ:String
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SubscriptionId

Určuje předplatné Azure, které má prostředek vytvořit. SubscriptionId je povinný parametr.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Určuje značky prostředků pro prostředek v Azure ve formě párů klíč-hodnota v tabulce hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Position:4
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TenantId

Určuje ID tenanta Azure.

Typ:String
Position:5
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UseDeviceAuthentication

Místo interaktivní výzvy prohlížeče použijte ověřování kódu zařízení.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

PSCustomObject. Returns following Properties in PSCustomObject

Výsledek: Úspěch nebo Neúspěch nebo Zrušeno. ResourceId: ID prostředku vytvořeného v Azure. PortalResourceURL: Adresa URL prostředku webu Azure Portal.