Connect-ServiceFabricCluster

Riferimento

Modulo:: ServiceFabric

Crea una connessione a un cluster di Service Fabric.

Sintassi

Connect-ServiceFabricCluster
       [[-ConnectionEndpoint] <String[]>]
       [-AllowNetworkConnectionOnly]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Connect-ServiceFabricCluster
       [-ConnectionEndpoint] <String[]>
       [-AllowNetworkConnectionOnly]
       [-WindowsCredential]
       [-ClusterSpn <String>]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Connect-ServiceFabricCluster
       [-ConnectionEndpoint] <String[]>
       [-AllowNetworkConnectionOnly]
       [-X509Credential]
       [-ServerCommonName <String[]>]
       [-ServerCertThumbprint <String[]>]
       -FindType <X509FindType>
       -FindValue <String>
       [-StoreLocation <StoreLocation>]
       [-StoreName <String>]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Connect-ServiceFabricCluster
       [-ConnectionEndpoint] <String[]>
       [-AllowNetworkConnectionOnly]
       [-ServerCommonName <String[]>]
       [-ServerCertThumbprint <String[]>]
       [-DSTS]
       -MetaDataEndpoint <String>
       [-CloudServiceName <String>]
       [-CloudServiceDNSNames <String[]>]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-Interactive <Boolean>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Connect-ServiceFabricCluster
       [-ConnectionEndpoint] <String[]>
       [-AllowNetworkConnectionOnly]
       [-ServerCommonName <String[]>]
       [-ServerCertThumbprint <String[]>]
       [-AzureActiveDirectory]
       [-SecurityToken <String>]
       [-GetMetadata]
       [-ConnectionInitializationTimeoutInSec <Double>]
       [-HealthOperationTimeoutInSec <Double>]
       [-HealthReportSendIntervalInSec <Double>]
       [-HealthReportRetrySendIntervalInSec <Double>]
       [-KeepAliveIntervalInSec <Double>]
       [-ServiceChangePollIntervalInSec <Double>]
       [-PartitionLocationCacheLimit <Int64>]
       [-AuthTokenBufferSize <Int64>]
       [-SkipChecks <Boolean>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Descrizione

Il cmdlet Connect-ServiceFabricCluster crea una connessione a un cluster autonomo di Service Fabric che consente di eseguire azioni di gestione per tale cluster. Dopo la connessione a un cluster, è possibile visualizzare le impostazioni della connessione usando il cmdlet Get-ServiceFabricClusterConnection .

Per gestire i cluster di Service Fabric, avviare Windows PowerShell usando l'opzione Esegui come amministratore.

Esempio

Esempio 1: Connettersi a un cluster

PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint "ServiceFabric01.ContosoCloudApp.net:19000"

Questo comando crea una connessione al cluster specificato.

Esempio 2: Connettersi a un cluster usando un certificato X.509

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    X509Credential = $True
    StoreLocation = 'CurrentUser'
    StoreName = "MY"
    ServerCommonName = "mycluster.cloudapp.net"
    FindType = 'FindByThumbprint'
    FindValue = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"   
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs

Questo comando si connette a un cluster usando un certificato X.509. Questo comando usa la funzionalità di splatting di Windows PowerShell per creare una tabella hash per i parametri e quindi le fornisce al cmdlet Connect-ServiceFabricCluster.

Esempio 3: Connettersi a un cluster gestito usando un certificato X.509

PS C:\> $resourceGroup = 'mycluster'
PS C:\> $managedCluster = Get-AzServiceFabricManagedCluster -ResourceGroupName $resourceGroup
PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = "$($managedCluster.Fqdn):$($managedCluster.ClientConnectionPort)"
    X509Credential = $true
    StoreLocation = 'CurrentUser'
    StoreName = "MY"
    ServerCertThumbprint = (Get-AzResource -ResourceId $managedCluster.Id).Properties.clusterCertificateThumbprints
    FindType = 'FindByThumbprint'
    FindValue = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"   
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs

Nota: Connessione a un cluster gestito richiede moduli di PowerShell 'Az.ServiceFabric' e 'Az.Resources' per eseguire query per le identificazioni personali del certificato server.

Questo comando esegue prima una query sulla risorsa cluster gestita per le identificazioni personali del certificato server corrente, quindi si connette al cluster usando il certificato X509. Specificare il nome del gruppo di risorse per il cluster gestito per recuperare le informazioni di connessione, incluso l'ID risorsa completo per il cluster gestito. Vedere Connettersi a un cluster gestito di Service Fabric.

Questo comando si connette quindi a un cluster usando un certificato X.509.

Esempio 4: Connettersi a un cluster con Azure Active Directory

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    AzureActiveDirectory = $True
    ServerCertThumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"
}
PS C:\> Connect-ServiceFabricCluster @ConnectArgs

Questo comando si connette a un cluster usando l'autenticazione di Azure Active Directory (AAD). Questo comando usa la funzionalità di splatting di Windows PowerShell per creare una tabella hash per i parametri e quindi le fornisce al cmdlet Connect-ServiceFabricCluster.

Esempio 5: Connettersi a un cluster protetto con un account del servizio gestito dal gruppo

PS C:\> $ConnectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    WindowsCredential = $True
    ClusterSpn = 'ServiceFabric/MyCluster.MyDomain.MyOrg'
}
PS C:\> Connect-ServiceFabricCluster @connectArgs

Questo comando usa la funzionalità di splatting di Windows PowerShell per creare una tabella hash per i parametri e quindi le fornisce al cmdlet Connect-ServiceFabricCluster.

Esempio 6: Connettersi a un cluster protetto con account computer

PS C:\> $connectArgs = @{  
    ConnectionEndpoint = 'mycluster.cloudapp.net:19000'
    WindowsCredential = $True
}
PS C:\> Connect-ServiceFabricCluster @connectArgs

Questo comando si connette a un cluster protetto con account computer.

Esempio 7: Connettersi a un cluster senza controlli primari

PS C:\> Connect-ServiceFabricCluster -ConnectionEndpoint -SkipChecks $True "ServiceFabric01.ContosoCloudApp.net:19000"

Questo comando crea una connessione al cluster specificato.

Parametri

-AllowNetworkConnectionOnly

Indica che il cmdlet consente la connessione al cluster anche quando i servizi di sistema non rispondono finché è possibile stabilire una connessione di rete sottostante.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AuthTokenBufferSize

Quando ci si connette con AzureActiveDirectory, specifica le dimensioni del buffer da allocare per l'acquisizione dei token di sicurezza.

Tipo:	Int64
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AzureActiveDirectory

Specifica che Azure Active Directory deve essere usato per l'autenticazione e l'autorizzazione.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CloudServiceDNSNames

Questo parametro è solo per uso interno.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CloudServiceName

Questo parametro è solo per uso interno.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ClusterSpn

Specifica il nome dell'entità di sicurezza del cluster da usare per le credenziali di Windows.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ConnectionEndpoint

Specifica una matrice di endpoint di connessione per il cluster nel formato ClusterAddress: ClientConnectionEndpoint, dove ClusterAddress è l'indirizzo IPv4, l'indirizzo IPv6 o il nome di dominio completo (FQDN) del nodo del cluster a cui connettersi e ClientConnectionEndpoint è la porta di connessione client specificata nel manifesto del cluster. Racchiudere gli indirizzi IPv6 tra parentesi quadre ([]). Gli endpoint validi hanno il formato seguente:

IPv4Address:ClientConnectionEndpoint [IPv6Address]:ClientConnectionEndpoint FQDN:ClientConnectionEndpoint

Tipo:	String[]
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ConnectionInitializationTimeoutInSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DSTS

Questo parametro è solo per uso interno.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FindType

Specifica il tipo di FindValue per la ricerca del certificato nell'archivio certificati. Sono supportati i tipi di filtro seguenti:

FindByThumbprint. Trovare il certificato in base all'identificazione personale del certificato.
FindBySubjectName. Cercare il certificato nell'archivio certificati in base al nome distinto soggetto o al nome comune, quando il nome distinto del soggetto viene specificato in FindValue, il nome soggetto nel certificato deve essere codificato nella codifica ASN a causa di una restrizione nell'API di crittografia nativa di Windows. Non esiste alcuna restrizione quando il nome comune viene fornito in FindValue.
FindBySubjectDistinguishedName
FindByIssuerName
FindByIssuerDistinguishedName
FindBySerialNumber
FindByTimeValid
FindByTimeNotYetValid
FindByTimeExpired
FindByTemplateName
FindByApplicationPolicy
FindByCertificatePolicy
FindByExtension
FindByKeyUsage
FindBySubjectKeyIdentifier

Tipo:	X509FindType
Valori accettati:	FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTimeExpired, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, FindBySubjectKeyIdentifier
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FindValue

Specifica il valore del filtro per la ricerca di un certificato nell'archivio certificati.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-GetMetadata

Quando ci si connette con AzureActiveDirectory, recupera in modo anonimo i metadati usati per l'acquisizione del token e non tenta l'autenticazione.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-HealthOperationTimeoutInSec

Specifica il periodo di timeout, espresso in secondi, per l'invio di report sull'integrità. Quando si verifica il timeout di un'operazione di integrità o si verifica un errore di comunicazione, il client di integrità ritenta internamente l'operazione.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-HealthReportRetrySendIntervalInSec

Specifica l'intervallo, espresso in secondi, in cui il client di integrità ritenta l'invio dei report che non sono stati inviati o che devono essere salvati in modo permanente nell'archivio integrità. Il valore minimo supportato è 1 secondo.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-HealthReportSendIntervalInSec

Specifica l'intervallo, espresso in secondi, in cui il client di integrità invia i report sull'integrità all'archivio integrità. Se impostato su 0, il client di integrità invierà immediatamente i report.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Interactive

Indica se il cmdlet funziona in modo interattivo.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-KeepAliveIntervalInSec

Specifica il periodo keep-alive della connessione in secondi. Questo intervallo impedisce che una connessione venga terminata a causa dell'inattività durante le operazioni eseguite in modo asincrono.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MetaDataEndpoint

Questo parametro è solo per uso interno.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PartitionLocationCacheLimit

Specifica il numero di partizioni memorizzate nella cache per la risoluzione del servizio. Il valore predefinito è 0, che indica nessun limite.

Tipo:	Int64
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SecurityToken

Quando ci si connette con AzureActiveDirectory, il token di sicurezza specificato viene usato direttamente per l'autenticazione e l'autorizzazione anziché eseguire l'accesso utente interattivo.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ServerCertThumbprint

Specifica una matrice delle identificazioni personali previste per il lato cluster. Queste identificazioni personali vengono usate per autenticare che il cmdlet si connette all'endpoint del cluster corretto durante x509 o l'autenticazione reciproca di Azure Active Directory.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ServerCommonName

Specifica una matrice dei nomi comuni previsti per il lato cluster. Questi nomi vengono usati per autenticare che il cmdlet si connette all'endpoint del cluster corretto durante l'autenticazione reciproca di x509 o Azure Active Directory.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ServiceChangePollIntervalInSec

Specifica l'intervallo, espresso in secondi, in cui il client di infrastruttura esegue il polling delle modifiche al servizio. Questo intervallo viene usato dal vecchio modello di notifiche di modifica dell'indirizzo del servizio basato sul polling.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SkipChecks

Indica di ignorare i controlli di convalida della velocità di risposta del servizio di sistema durante la connessione al cluster.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-StoreLocation

Specifica il percorso dell'archivio di un certificato. I valori accettabili per questo parametro sono:

CurrentUser
LocalMachine

Tipo:	StoreLocation
Valori accettati:	CurrentUser, LocalMachine
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-StoreName

Specifica il nome dell'archivio certificati per caricare il certificato client.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-TimeoutSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WindowsCredential

Indica che il cmdlet usa le credenziali di Windows per connettersi a un cluster di Service Fabric.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-X509Credential

Indica che il cmdlet usa un certificato x509 per eseguire l'autenticazione reciproca con un cluster di Service Fabric.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

None

Output

System.Object

Condividi tramite

Connect-ServiceFabricCluster

Sintassi

Descrizione

Esempio

Esempio 1: Connettersi a un cluster

Esempio 2: Connettersi a un cluster usando un certificato X.509

Esempio 3: Connettersi a un cluster gestito usando un certificato X.509

Esempio 4: Connettersi a un cluster con Azure Active Directory

Esempio 5: Connettersi a un cluster protetto con un account del servizio gestito dal gruppo

Esempio 6: Connettersi a un cluster protetto con account computer

Esempio 7: Connettersi a un cluster senza controlli primari

Parametri

-AllowNetworkConnectionOnly

-AuthTokenBufferSize

-AzureActiveDirectory

-CloudServiceDNSNames

-CloudServiceName

-ClusterSpn

-ConnectionEndpoint

-ConnectionInitializationTimeoutInSec

-DSTS

-FindType

-FindValue

-GetMetadata

-HealthOperationTimeoutInSec

-HealthReportRetrySendIntervalInSec

-HealthReportSendIntervalInSec

-Interactive

-KeepAliveIntervalInSec

-MetaDataEndpoint

-PartitionLocationCacheLimit

-SecurityToken

-ServerCertThumbprint

-ServerCommonName

-ServiceChangePollIntervalInSec

-SkipChecks

-StoreLocation

-StoreName

-TimeoutSec

-WindowsCredential

-X509Credential

Input

Output

Collegamenti correlati

Risorse aggiuntive