Register-AzStackHCI

Riferimento

Modulo:: Az.StackHCI

Register-AzStackHCI crea una risorsa cloud Microsoft.AzureStackHCI che rappresenta il cluster locale e registra il cluster locale con Azure.

Sintassi

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>]

Descrizione

Register-AzStackHCI crea una risorsa cloud Microsoft.AzureStackHCI che rappresenta il cluster locale e registra il cluster locale con Azure.

Esempio

Esempio 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/

Richiamo su uno dei nodi del cluster.

Esempio 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/

Richiamo dal nodo di gestione.

Esempio 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/

Richiamo da WAC.

Esempio 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/

Richiamare con tutti i parametri.

Parametri

-AccountId

Specifica l'ID account. Specificando questo insieme ad ArmAccessToken, si evita l'accesso interattivo di Azure.

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

-ArcServerResourceGroupName

Specifica il nome del gruppo di risorse Arc. Se non specificato, verrà usato il nome del gruppo di risorse del cluster.

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

-ArcSpnCredential

Specifica le credenziali da usare per l'onboarding dell'agente ARC. Se non specificato, verrà generato un nuovo set di credenziali.

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

-ArmAccessToken

Specifica il token di accesso arm. Specificando questo insieme a AccountId, si evita l'accesso interattivo di Azure.

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

-CertificateThumbprint

Specifica l'identificazione personale del certificato disponibile in tutti i nodi. L'utente è responsabile della gestione del certificato.

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

-ComputerName

Specifica il nome del cluster o uno dei nodi del cluster nel cluster locale che viene registrato in Azure.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-Credential

Specifica le credenziali per ComputerName. Il valore predefinito è l'utente corrente che esegue il cmdlet.

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

-EnvironmentName

Specifica l'ambiente di Azure. Il valore predefinito è AzureCloud. I valori validi sono AzureCloud, AzureChinaCloud, AzurePPE, AzureCanary, AzureUSGovernment

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

-IsWAC

Le registrazioni tramite Windows Amministrazione Center specificano questo parametro su true.

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

-LogsDirectory

Specifica il percorso in cui salvare i file di log. Deve essere un percorso assoluto. Il valore predefinito è: C:\ProgramData\AzureStackHCI

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

-Region

Specifica l'area per creare la risorsa. Region è un parametro Obbligatorio.

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

-RepairRegistration

Ripristinare la registrazione corrente di Azure Stack HCI con il cloud. Questo cmdlet elimina i certificati locali nei nodi in cluster e i certificati remoti nell'applicazione Azure AD nel cloud e genera nuovi certificati sostitutivi per entrambi. Vengono mantenuti il gruppo di risorse, il nome della risorsa e altre opzioni di registrazione.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse di Azure. Se non specificato <LocalClusterName-rg>, verrà usato come nome del gruppo di risorse.

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

-ResourceName

Specifica il nome della risorsa creata in Azure. Se non specificato, viene usato il nome del cluster locale.

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

-SubscriptionId

Specifica la sottoscrizione di Azure per creare la risorsa. SubscriptionId è un parametro Obbligatorio.

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

-Tag

Specifica i tag di risorsa per la risorsa in Azure sotto forma di coppie chiave-valore in una tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

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

-TenantId

Specifica l'ID tenant di Azure.

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

-UseDeviceAuthentication

Usare l'autenticazione del codice del dispositivo anziché un prompt interattivo del browser.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Output

PSCustomObject. Returns following Properties in PSCustomObject

Risultato: operazione riuscita o non riuscita o annullata. ResourceId: ID risorsa della risorsa creata in Azure. PortalResourceURL: URL risorsa del portale di Azure.