Register-AzStackHCI

  • Referenz
Modul:
Az.StackHCI

Register-AzStackHCI erstellt eine Microsoft.AzureStackHCI-Cloudressource, die den lokalen Cluster darstellt und den lokalen Cluster mit Azure registriert.

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

Beschreibung

Register-AzStackHCI erstellt eine Microsoft.AzureStackHCI-Cloudressource, die den lokalen Cluster darstellt und den lokalen Cluster mit Azure registriert.

Beispiele

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

Aufrufen auf einen der Clusterknoten.

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

Aufrufen vom Verwaltungsknoten.

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

Aufrufen von WAC.

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

Aufrufen aller Parameter.

Parameter

-AccountId

Gibt die Konto-ID an. Wenn Sie diese zusammen mit ArmAccessToken angeben, wird die interaktive Azure-Anmeldung vermieden.

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

-ArcServerResourceGroupName

Gibt den Namen der Arc-Ressourcengruppe an. Wenn nicht angegeben, wird der Name der Clusterressourcengruppe verwendet.

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

-ArcSpnCredential

Gibt die Anmeldeinformationen an, die für das Onboarding von ARC-Agent verwendet werden sollen. Wenn nicht angegeben, werden neue Anmeldeinformationen generiert.

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

-ArmAccessToken

Gibt das ARM-Zugriffstoken an. Wenn Sie diese Zusammen mit AccountId angeben, wird die interaktive Azure-Anmeldung vermieden.

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

-CertificateThumbprint

Gibt den Fingerabdruck des Zertifikats an, das auf allen Knoten verfügbar ist. Der Benutzer ist für die Verwaltung des Zertifikats verantwortlich.

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

-ComputerName

Gibt den Clusternamen oder einen der Clusterknoten im lokalen Cluster an, der in Azure registriert wird.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Credential

Gibt die Anmeldeinformationen für computerName an. Der Standardwert ist der aktuelle Benutzer, der das Cmdlet ausführt.

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

-EnvironmentName

Gibt die Azure-Umgebung an. Der Standardwert ist „AzureCloud“. Gültige Werte sind AzureCloud, AzureChinaCloud, AzurePPE, AzureCanary, AzureUSGovernment

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

-IsWAC

Registrierungen über Windows Admin Center gibt diesen Parameter auf "true" an.

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

-LogsDirectory

Gibt den Pfad an, in dem die Protokolldateien gespeichert werden sollen. Muss ein absoluter Pfad sein. Standardwert wäre: C:\ProgramData\AzureStackHCI

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

-Region

Gibt den Bereich an, der die Ressource erstellen soll. Region ist ein obligatorischer Parameter.

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

-RepairRegistration

Reparieren Sie die aktuelle Azure Stack HCI-Registrierung mit der Cloud. Dieses Cmdlet löscht die lokalen Zertifikate auf den gruppierten Knoten und die Remotezertifikate in der Azure AD-Anwendung in der Cloud und generiert neue Ersatzzertifikate für beide. Die Ressourcengruppe, der Ressourcenname und andere Registrierungsoptionen bleiben erhalten.

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

-ResourceGroupName

Gibt den Namen der Azure-Ressourcengruppe an. Wenn nicht angegeben <, wird LocalClusterName-rg> als Ressourcengruppenname verwendet.

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

-ResourceName

Gibt den Ressourcennamen der in Azure erstellten Ressource an. Wenn nicht angegeben, wird der lokale Clustername verwendet.

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

-SubscriptionId

Gibt das Azure-Abonnement an, um die Ressource zu erstellen. SubscriptionId ist ein obligatorischer Parameter.

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

-Tag

Gibt die Ressourcentags für die Ressource in Azure in Form von Schlüsselwertpaaren in einer Hashtabelle an. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

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

-TenantId

Gibt die Azure TenantId an.

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

-UseDeviceAuthentication

Verwenden Sie die Gerätecodeauthentifizierung anstelle einer interaktiven Browseraufforderung.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Ausgaben

PSCustomObject. Returns following Properties in PSCustomObject

Ergebnis: Erfolgreich oder fehlgeschlagen oder abgebrochen. ResourceId: Ressourcen-ID der ressource, die in Azure erstellt wurde. PortalResourceURL: Azure Portal-Ressourcen-URL.