Add-DataGatewayCluster
Hiermee maakt u een nieuw gegevensgatewaycluster zodra de gateway op een computer is geïnstalleerd
Syntaxis
Default (Standaard)
Add-DataGatewayCluster
-RecoveryKey <SecureString>
-GatewayName <String>
[-RegionKey <String>]
[-OverwriteExistingGateway]
[<CommonParameters>]
Description
Hiermee maakt u een nieuw gegevensgatewaycluster zodra de gateway op een computer is geïnstalleerd
Voorbeelden
Voorbeeld 1
PS C:\> Add-DataGatewayCluster -Name "MyNewGateway" -RecoveryKey (Read-Host "Enter Recovery Key" -AsSecureString)
Hiermee maakt u een nieuwe gateway met de naam MyNewGateway.
Voorbeeld 2
PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter Recovery Key" -AsSecureString) | Out-File -FilePath .\encryptedRecoveryKey.txt
PS C:\> $secureRecoveryKey = (cat .\encryptedRecoveryKey.txt | ConvertTo-SecureString)
PS C:\> Add-DataGatewayCluster -RecoveryKey $secureRecoveryKey -Name "MyNewGateway" -RegionKey brazilsouth
Hiermee maakt u een nieuwe gateway met de naam 'MyNewGateway' in de regio Brazilië - zuid. U kunt de versleutelde herstelsleutel veilig opslaan in een bestand en deze doorgeven aan Add-DataGatewayCluster zonder enige tussenkomst van de gebruiker.
Voorbeeld 3
PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter Recovery Key" -AsSecureString) | Out-File -FilePath .\encryptedRecoveryKey.txt
PS C:\> $secureRecoveryKey = (cat .\encryptedRecoveryKey.txt | ConvertTo-SecureString)
PS C:\> Add-DataGatewayCluster -RecoveryKey $secureRecoveryKey -Name "MyNewGateway" -RegionKey brazilsouth -OverwriteExistingGateway
Hiermee maakt u een nieuwe gateway met de naam 'MyNewGateway' in de regio Brazilië - zuid en overschrijft u de gatewayconfiguratie die op die lokale computer bestaat en configureert u de nieuwe. U kunt de versleutelde herstelsleutel veilig opslaan in een bestand en deze doorgeven aan Add-DataGatewayCluster zonder enige tussenkomst van de gebruiker.
Parameters
-GatewayName
Dit is de naam van het gatewaycluster dat wordt gemaakt. Het kan niet conflicteren met bestaande gateways op dezelfde tenant.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Naam |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-OverwriteExistingGateway
Wanneer deze parameter is ingesteld, wordt de bestaande gatewayconfiguratie op de lokale computer overschreven en wordt een nieuwe geconfigureerd. De overschreven gateway kan nog steeds worden hersteld op een andere computer.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-RecoveryKey
De herstelsleutel wordt door de gateway gebruikt om on-premises inloggegevens te versleutelen/ontsleutelen. Dit is ook nodig om de gateway te herstellen of een nieuw lid toe te voegen aan het gatewaycluster.
Parametereigenschappen
| Type: | SecureString |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-RegionKey
Deze parameter geeft de Azure-regio aan die is gekoppeld aan uw gateway. Wanneer er geen RegionKey is opgegeven, wordt de standaard Power BI-regio voor uw tenant gebruikt.
Voer de cmdlet Get-DataGatewayRegion uit om de lijst met beschikbare regioparameters op te halen
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
None
Uitvoerwaarden
System.Void
Notities
Deze opdracht moet worden uitgevoerd met een op de gebruiker gebaseerde referentie.