> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/it/comandi-powershell/set-psuauthenticationmethod.md). # Set-PSUAuthenticationMethod ## SINOSSI Imposta le impostazioni del metodo di autenticazione. ## SINTASSI ### Type (Predefinito) ``` Set-PSUAuthenticationMethod [-ScriptBlock ] [-Type ] [-Disabled] [-Configure ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### SAML2 ``` Set-PSUAuthenticationMethod [-ScriptBlock ] [-Type ] [-Disabled] -CallbackPath [-MetadataAddress ] [-SigningKey ] [-EntityId ] [-IdentityProviderEntityId ] [-ServiceCertificate ] [-SingleSignOnServiceUrl ] [-Configure ] [-AllowUnsolicitedAuthnResponse] [-NameIdPolicy ] [-LoadMetadata] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### OIDC ``` Set-PSUAuthenticationMethod [-ScriptBlock ] [-Type ] [-Disabled] -CallbackPath -ClientId [-ClientSecret ] [-Resource ] [-Authority ] [-ResponseType ] [-SaveTokens ] [-UseTokenLifetime ] [-RequireMfa] [-GetClaimsFromUserInfoEndpoint ] [-Scopes ] [-CorrelationCookieSameSite ] [-Configure ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### WSFed ``` Set-PSUAuthenticationMethod [-ScriptBlock ] [-Type ] [-Disabled] -CallbackPath [-UseTokenLifetime ] [-CorrelationCookieSameSite ] -Wtrealm -Wreply -MetadataAddress [-Configure ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### LogoutUrl ``` Set-PSUAuthenticationMethod [-ScriptBlock ] [-Type ] [-Disabled] [-LogoutUrl ] [-Configure ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Form ``` Set-PSUAuthenticationMethod [-ScriptBlock ] [-Type ] [-Disabled] [-Configure ] [-Native] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Domain ``` Set-PSUAuthenticationMethod [-ScriptBlock ] [-Type ] [-Disabled] [-Configure ] [-Domain ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIZIONE Imposta le impostazioni del metodo di autenticazione. Le impostazioni di autenticazione sono memorizzate in .universal/authentication.ps1 È inoltre possibile utilizzare questo cmdlet con l'API di gestione di PowerShell Universal. ## ESEMPI ### Esempio 1 ``` PS C:\> Set-PSUAuthenticationMethod -ScriptBlock { param($Credential) if ($Credential.UserName -eq 'Adam') { New-PSUAuthenticationResult -Success -UserName 'Adam' } else { New-PSUAuthenticationResult -ErrorMessage 'Not Adam!' } } ``` I blocchi di script per l'autenticazione basata su form ricevono un unico parametro $Credential che contiene un oggetto PSCredential. È necessario restituire un New-PSUAuthenticationResult dal blocco di script per concedere o negare l'accesso. ## PARAMETRI ### -AppToken L'AppToken utilizzato per chiamare l'API di gestione di PowerShell Universal. È anche possibile chiamare Connect-PSUServer prima di eseguire questo cmdlet per impostare l'AppToken per l'intera sessione. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Specifica il nome del computer o l'URL da chiamare quando si accede all'API di gestione di PowerShell Universal. È anche possibile utilizzare Connect-PSUServer prima di eseguire questo cmdlet per impostare il nome del computer per l'intera sessione. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ScriptBlock Il blocco di script da eseguire quando un utente effettua l'accesso. ```yaml Type: ScriptBlock Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Disabled Indica se l'autenticazione basata su form è disabilitata. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Utilizza le credenziali predefinite durante la connessione all'API di gestione ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Authority L'URL dell'autorità OpenID Connect. ```yaml Type: String Parameter Sets: OIDC Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -CallbackPath Il percorso di callback che l'autorità chiamerà dopo l'autenticazione. ```yaml Type: String Parameter Sets: SAML2, OIDC, WSFed Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ClientId Il Client ID OpenID Connect da fornire all'autorità. ```yaml Type: String Parameter Sets: OIDC Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ClientSecret Il Client Secret OpenID Connect da fornire all'autorità. ```yaml Type: String Parameter Sets: OIDC Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Configure Script di configurazione aggiuntivo che può essere eseguito per aggiornare le impostazioni del provider di autenticazione. Consulti la nostra documentazione online per maggiori informazioni. ```yaml Type: ScriptBlock Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -CorrelationCookieSameSite L'impostazione CorrelationCookieSameSite da utilizzare per l'autenticazione OpenID Connect o WS-Federation. ```yaml Type: String Parameter Sets: OIDC, WSFed Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -EntityId L'ID entità per l'autenticazione SAML2. ```yaml Type: String Parameter Sets: SAML2 Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -GetClaimsFromUserInfoEndpoint Indica se restituire informazioni aggiuntive sui claim dall'autorità OpenID Connect. Questa impostazione non è supportata da tutte le autorità. ```yaml Type: Boolean Parameter Sets: OIDC Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -IdentityProviderEntityId L'ID entità dell'Identity Provider per l'autenticazione SAML2. Di solito è l'URL da chiamare per l'autenticazione. ```yaml Type: String Parameter Sets: SAML2 Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Esegue il comando internamente anziché utilizzare l'API di gestione. Funziona solo quando lo script viene eseguito all'interno di PowerShell Universal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -MetadataAddress L'indirizzo dei metadati SAML2 o WS-Federation. Per SAML2, deve essere specificato se è diverso dall'ID entità dell'Identity Provider. Per WS-Federation, questa impostazione è obbligatoria. ```yaml Type: String Parameter Sets: SAML2 Aliases: MetadataUrl Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ```yaml Type: String Parameter Sets: WSFed Aliases: MetadataUrl Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Resource Una risorsa per la quale concedere un token durante l'autenticazione con OpenID Connect. ```yaml Type: String Parameter Sets: OIDC Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ResponseType Il tipo di risposta OpenID Connect. Può essere token o code. ```yaml Type: String Parameter Sets: OIDC Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SaveTokens Indica se salvare i token all'interno del cookie OpenID Connect. ```yaml Type: Boolean Parameter Sets: OIDC Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Scopes Gli ambiti da richiedere durante l'autenticazione OpenID Connect. ```yaml Type: String Parameter Sets: OIDC Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ServiceCertificate Il certificato di servizio da utilizzare durante l'autenticazione con l'Identity Provider SAML2. ```yaml Type: String Parameter Sets: SAML2 Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Type Il tipo di metodo di autenticazione. ```yaml Type: AuthenticationMethodType Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseTokenLifetime Indica se utilizzare la durata del token come durata del cookie. ```yaml Type: Boolean Parameter Sets: OIDC, WSFed Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Wreply L'impostazione Wreply di WS-Federation. ```yaml Type: String Parameter Sets: WSFed Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Wtrealm L'impostazione Wrealm di WS-Federation. ```yaml Type: String Parameter Sets: WSFed Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -RequireMfa Applica il requisito MFA per OpenID Connect. ```yaml Type: SwitchParameter Parameter Sets: OIDC Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SigningKey Una chiave di firma del certificato da utilizzare con SAML2. ```yaml Type: String Parameter Sets: SAML2 Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SingleSignOnServiceUrl L'URL del servizio di single sign-on per SAML2. ```yaml Type: String Parameter Sets: SAML2 Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LogoutUrl L'URL di logout per OpenAPI Connect o WS-Federation. ```yaml Type: String Parameter Sets: LogoutUrl Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AllowUnsolicitedAuthnResponse Consente risposte di autenticazione non sollecitate per SAML2. ```yaml Type: SwitchParameter Parameter Sets: SAML2 Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Credenziali per accedere all'API di gestione di PowerShell Universal. ```yaml Type: PSCredential Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Indica se il cmdlet deve ignorare i problemi relativi ai certificati. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoadMetadata Indica se caricare i metadati per l'autenticazione SAML2. ```yaml Type: SwitchParameter Parameter Sets: SAML2 Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -NameIdPolicy I criteri Name ID di SAML2. ```yaml Type: String Parameter Sets: SAML2 Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Domain Il dominio a cui accedere quando si utilizza l'autenticazione nativa. ```yaml Type: String Parameter Sets: Domain Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Native L'autenticazione basata su form utilizzerà il sistema operativo nativo per l'accesso. Attualmente supportata solo su Windows. ```yaml Type: SwitchParameter Parameter Sets: Form Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Riutilizza e mantiene i cookie di autenticazione per la sessione PowerShell corrente. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable e -ProgressAction. Per maggiori informazioni, consulti [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUT ### Nessuno ## OUTPUT ### System.Object ## NOTE ## LINK CORRELATI [New-PSUAuthenticationResult](/powershell-universal/it/comandi-powershell/new-psuauthenticationresult.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/it/comandi-powershell/set-psuauthenticationmethod.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.