Register-AzStackHCI
Register-AzStackHCI erstellt eine Microsoft.AzureStackHCI-Cloudressource, die den lokalen Cluster darstellt und den lokalen Cluster bei 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 bei 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.
Typ: | String |
Position: | 8 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ArcServerResourceGroupName
Gibt den Namen der Arc-Ressourcengruppe an. Wenn nicht angegeben, wird der Name der Clusterressourcengruppe verwendet.
Typ: | String |
Position: | 13 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ArcSpnCredential
Gibt die Anmeldeinformationen an, die für das Onboarding von ARC-Agent verwendet werden sollen. Wenn nicht angegeben, werden neue Anmeldeinformationen generiert.
Typ: | PSCredential |
Position: | 14 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ArmAccessToken
Gibt das ARM-Zugriffstoken an. Wenn Sie diese Zusammen mit AccountId angeben, wird die interaktive Azure-Anmeldung vermieden.
Typ: | String |
Position: | 7 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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.
Typ: | String |
Position: | 11 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ComputerName
Gibt den Clusternamen oder einen der Clusterknoten im lokalen Cluster an, der in Azure registriert wird.
Typ: | String |
Position: | 10 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt die Anmeldeinformationen für computerName an. Der Standardwert ist der aktuelle Benutzer, der das Cmdlet ausführt.
Typ: | PSCredential |
Position: | 12 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-EnvironmentName
Gibt die Azure-Umgebung an. Der Standardwert ist AzureCloud. Gültige Werte sind AzureCloud, AzureChinaCloud, AzurePPE, AzureCanary, AzureUSGovernment
Typ: | String |
Position: | 9 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-IsWAC
Registrierungen über Windows Admin Center gibt diesen Parameter auf "true" an.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-LogsDirectory
Gibt den Pfad an, in dem die Protokolldateien gespeichert werden sollen. Muss ein absoluter Pfad sein. Standardwert wäre: C:\ProgramData\AzureStackHCI
Typ: | String |
Position: | 15 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Region
Gibt den Bereich an, der die Ressource erstellen soll. Region ist ein obligatorischer Parameter.
Typ: | String |
Position: | 2 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ResourceGroupName
Gibt den Namen der Azure-Ressourcengruppe an. Wenn <LocalClusterName>-rg nicht angegeben wird, wird sie als Ressourcengruppenname verwendet.
Typ: | String |
Position: | 6 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ResourceName
Gibt den Ressourcennamen der in Azure erstellten Ressource an. Wenn nicht angegeben, wird der lokale Clustername verwendet.
Typ: | String |
Position: | 3 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SubscriptionId
Gibt das Azure-Abonnement an, um die Ressource zu erstellen. SubscriptionId ist ein obligatorischer Parameter.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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"}
Typ: | Hashtable |
Position: | 4 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TenantId
Gibt die Azure TenantId an.
Typ: | String |
Position: | 5 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UseDeviceAuthentication
Verwenden Sie die Gerätecodeauthentifizierung anstelle einer interaktiven Browseraufforderung.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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.
Azure PowerShell