Set-SPProfileServiceApplication

Riferimento

Modulo:: sharepoint-server

Si applica a:: SharePoint Server Subscription Edition

Imposta le proprietà di un'applicazione del servizio profili utente.

Sintassi

Set-SPProfileServiceApplication
   [-Identity] <SPServiceApplicationPipeBind>
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-GetNonImportedObjects <Boolean>]
   [-MySiteHostLocation <SPSitePipeBind>]
   [-ProfileDBCredentials <PSCredential>]
   [-ProfileSyncDBCredentials <PSCredential>]
   [-ProfileSyncDBFailoverServer <String>]
   [-PurgeNonImportedObjects <Boolean>]
   [-SocialDBCredentials <PSCredential>]
   [-SocialDBFailoverServer <String>]
   [-Name <String>]
   [-UseOnlyPreferredDomainControllers <Boolean>]
   [-WhatIf]
   [-ProfileDBFailoverServer <String>]
   [<CommonParameters>]

Set-SPProfileServiceApplication
   [-Identity] <SPServiceApplicationPipeBind>
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-GetNonImportedObjects <Boolean>]
   -MySiteHostLocation <SPSitePipeBind>
   [-MySiteManagedPath <SPPrefixPipeBind>]
   [-ProfileDBCredentials <PSCredential>]
   [-ProfileSyncDBCredentials <PSCredential>]
   [-ProfileSyncDBFailoverServer <String>]
   [-PurgeNonImportedObjects <Boolean>]
   [-SiteNamingConflictResolution <String>]
   [-SocialDBCredentials <PSCredential>]
   [-SocialDBFailoverServer <String>]
   [-Name <String>]
   [-UseOnlyPreferredDomainControllers <Boolean>]
   [-WhatIf]
   [-ProfileDBFailoverServer <String>]
   [<CommonParameters>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Il cmdlet Set-SPProfileServiceApplication imposta le proprietà di un'applicazione di Servizio profili utente.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

---------------ESEMPIO---------------------

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'User Profile Service Application'}
Set-SPProfileServiceApplication -Identity $sa -PurgeNonImportedObjects:$true

In questo esempio vengono eliminati gli oggetti dal database Profile che non rientrano nell'ambito dell'importazione del profilo utente.

Parametri

-ApplicationPool

Specifica il pool di applicazioni IIS esistente in cui eseguire il servizio Web per l'applicazione di servizio.

Il tipo deve essere un GUID valido in formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un pool di applicazioni, ad esempio NomePoolApplicazioni1, oppure un'istanza di un oggetto IISWebServiceApplicationPool valido.

Type:	SPIisWebServiceApplicationPoolPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-GetNonImportedObjects

Specifica se informare gli utenti che non provengono dalla pipeline di importazione e che verranno contrassegnati per l'eliminazione. L'elenco di utenti contrassegnati per l'eliminazione viene visualizzato nella finestra della console.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

Specifica l'applicazione di Servizio profili utente da aggiornare.

Il tipo deve essere un GUID valido in formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un'applicazione di PerformancePoint Service, ad esempio ApplicazionePerformancePoint1, oppure un'istanza di un oggetto SPServiceApplication valido.

Type:	SPServiceApplicationPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MySiteHostLocation

Specifica la raccolta siti in cui verrà effettuato il provisioning del sito personale.

Il tipo deve essere un URL valido nel formato https://server_name. un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di una sottoscrizione di sito (ad esempio SottoscrizioneSito1) oppure un'istanza di un oggetto SiteSubscription valido.

Type:	SPSitePipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MySiteManagedPath

Specifica il percorso gestito di siti personali.

Il tipo deve essere un URL valido nel formato https://server_name.

Type:	SPPrefixPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Name

Specifica il nome visualizzato per la nuova applicazione del servizio profili utente. Il nome usato deve essere un nome univoco di un'applicazione del servizio profili utente in questa farm. La lunghezza massima del nome è 128 caratteri.

Il tipo deve essere un nome valido di un'applicazione di Servizio profili utente, ad esempio ApplicazioneServizioProfiliUtente1.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ProfileDBCredentials

Specifica il set di credenziali di sicurezza, ad esempio nome utente e password, utilizzato per connettersi al database dei profili utente creato dal cmdlet.

Il tipo deve essere un oggetto PSCredential valido.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ProfileDBFailoverServer

Specifica il nome del server SQL Server di failover per il database dei profili. Viene utilizzato per creare la stringa di connessione per il database dei profili.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ProfileSyncDBCredentials

Specifica il set di credenziali di sicurezza, ad esempio nome utente e password, che verrà utilizzato per connettersi al database di sincronizzazione dei profili specificato nel parametro ProfileSyncDBName.

Il tipo deve essere un oggetto PSCredential valido.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ProfileSyncDBFailoverServer

Specifica il nome del server SQL Server di failover per il database dei profili. Viene utilizzato per creare la stringa di connessione per il database dei profili.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-PurgeNonImportedObjects

Specifica se contrassegnare per l'eliminazione nell'archivio dei profili gli utenti non importati e quindi informare gli utenti non provenienti dalla pipeline di importazione che verranno contrassegnati per l'eliminazione. L'elenco di utenti contrassegnati per l'eliminazione viene visualizzato nella finestra della console.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SiteNamingConflictResolution

Specifica il formato da utilizzare per denominare i siti personali.

Utilizzare uno dei valori interi seguenti:

1. Ad esempio, https://portal_site/location/username/

2. Le raccolte siti personali devono basarsi sui nomi utente con risoluzione dei conflitti tramite i nomi di dominio, ad esempio .../nomeutente/ oppure .../dominio_nomeutente/

3 Le raccolte siti personali devono essere denominate usando sempre il dominio e il nome utente, per evitare conflitti. Ad esempio, https://portal_site/location/domain_username/

Il valore predefinito è 1 (i conflitti non vengono risolti).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SocialDBCredentials

Set di credenziali di sicurezza, che comprende nome utente e password, utilizzato per connettersi al database di social networking creato dal cmdlet.

Il tipo deve essere un oggetto PSCredential valido.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SocialDBFailoverServer

Specifica il nome del server SQL Server di failover per il database di social networking. Viene utilizzato per creare la stringa di connessione per il database di social networking.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-UseOnlyPreferredDomainControllers

Limita la comunicazione per la sincronizzazione dei profili a un controller di dominio specifico.

I valori validi sono $true e $false.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

Condividi tramite

Set-SPProfileServiceApplication

Sintassi

Descrizione

Esempio

---------------ESEMPIO---------------------

Parametri

-ApplicationPool

-AssignmentCollection

-Confirm

-GetNonImportedObjects

-Identity

-MySiteHostLocation

-MySiteManagedPath

-Name

-ProfileDBCredentials

-ProfileDBFailoverServer

-ProfileSyncDBCredentials

-ProfileSyncDBFailoverServer

-PurgeNonImportedObjects

-SiteNamingConflictResolution

-SocialDBCredentials

-SocialDBFailoverServer

-UseOnlyPreferredDomainControllers

-WhatIf

Commenti e suggerimenti

Risorse aggiuntive