Add-DataGatewayCluster

Riferimento

Modulo:: DataGateway

Crea un nuovo cluster gateway dati dopo l'installazione del gateway in un computer

Nota: per usare questo cmdlet, la versione del gateway deve essere 3000.37.35 (aprile 2020) o successiva.

Sintassi

Add-DataGatewayCluster
   -RecoveryKey <SecureString>
   -GatewayName <String>
   [-RegionKey <String>]
   [-OverwriteExistingGateway]
   [<CommonParameters>]

Descrizione

Crea un nuovo cluster gateway dati dopo l'installazione del gateway in un computer

Esempio

Esempio 1

PS C:\> Add-DataGatewayCluster -Name "MyNewGateway" -RecoveryKey (Read-Host "Enter Recovery Key" -AsSecureString)

Crea un nuovo gateway denominato "MyNewGateway".

Esempio 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

Crea un nuovo gateway denominato "MyNewGateway" nell'area Brasile meridionale. È possibile archiviare in modo sicuro la chiave di ripristino crittografata in un file e passarvi in Add-DataGatewayCluster senza alcuna interazione dell'utente.

Esempio 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

Crea un nuovo gateway denominato "MyNewGateway" nell'area Brasile meridionale e sovrascrive la configurazione del gateway esistente nel computer locale e ne configura una nuova. È possibile archiviare in modo sicuro la chiave di ripristino crittografata in un file e passarvi in Add-DataGatewayCluster senza alcuna interazione dell'utente.

Parametri

-GatewayName

Si tratta del nome del cluster gateway che verrà creato. Non può essere in conflitto con i gateway esistenti nello stesso tenant.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OverwriteExistingGateway

Quando questo parametro viene impostato, sovrascrive la configurazione del gateway esistente nel computer locale e ne configura una nuova. Il gateway sovrascritto può comunque essere ripristinato in un altro computer.

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

-RecoveryKey

La chiave di ripristino viene usata dal gateway per crittografare/decrittografare le credenziali locali. Questa operazione viene anche riusata per ripristinare il gateway o aggiungere un nuovo membro al cluster del gateway.

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

-RegionKey

Questo parametro indica l'area di Azure associata al gateway. Quando non viene specificato un elemento RegionKey, viene usata l'area predefinita di Power BI per il tenant. Per ottenere l'elenco dei parametri dell'area disponibili, eseguire il Get-DataGatewayRegion cmdlet

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

Input

None

Output

System.Void

Note

Questo comando deve essere eseguito con credenziali basate sull'utente.

Condividi tramite