Condividi tramite


Update-AzADUser

Aggiorna l'entità negli utenti

Sintassi

Update-AzADUser
      -UPNOrObjectId <String>
      [-AccountEnabled <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-AgeGroup <String>]
      [-City <String>]
      [-CompanyName <String>]
      [-ConsentProvidedForMinor <String>]
      [-Country <String>]
      [-DeletedDateTime <DateTime>]
      [-Department <String>]
      [-DisplayName <String>]
      [-EmployeeHireDate <DateTime>]
      [-EmployeeId <String>]
      [-EmployeeType <String>]
      [-ExternalUserState <String>]
      [-ExternalUserStateChangeDateTime <DateTime>]
      [-FaxNumber <String>]
      [-GivenName <String>]
      [-Id <String>]
      [-Identity <IMicrosoftGraphObjectIdentity[]>]
      [-IsResourceAccount]
      [-JobTitle <String>]
      [-Mail <String>]
      [-MailNickname <String>]
      [-OfficeLocation <String>]
      [-OnPremisesImmutableId <String>]
      [-OtherMail <String[]>]
      [-PasswordPolicy <String>]
      [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
      [-PostalCode <String>]
      [-PreferredLanguage <String>]
      [-ShowInAddressList]
      [-State <String>]
      [-StreetAddress <String>]
      [-Surname <String>]
      [-UsageLocation <String>]
      [-UserType <String>]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADUser
      [-AccountEnabled <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-AgeGroup <String>]
      [-City <String>]
      [-CompanyName <String>]
      [-ConsentProvidedForMinor <String>]
      [-Country <String>]
      [-DeletedDateTime <DateTime>]
      [-Department <String>]
      [-DisplayName <String>]
      [-EmployeeHireDate <DateTime>]
      [-EmployeeId <String>]
      [-EmployeeType <String>]
      [-ExternalUserState <String>]
      [-ExternalUserStateChangeDateTime <DateTime>]
      [-FaxNumber <String>]
      [-GivenName <String>]
      [-Id <String>]
      [-Identity <IMicrosoftGraphObjectIdentity[]>]
      [-IsResourceAccount]
      [-JobTitle <String>]
      [-Mail <String>]
      [-MailNickname <String>]
      [-OfficeLocation <String>]
      [-OnPremisesImmutableId <String>]
      [-OtherMail <String[]>]
      [-PasswordPolicy <String>]
      [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
      [-PostalCode <String>]
      [-PreferredLanguage <String>]
      [-ShowInAddressList]
      [-State <String>]
      [-StreetAddress <String>]
      [-Surname <String>]
      [-UsageLocation <String>]
      [-UserType <String>]
      -ObjectId <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADUser
      [-AccountEnabled <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-AgeGroup <String>]
      [-City <String>]
      [-CompanyName <String>]
      [-ConsentProvidedForMinor <String>]
      [-Country <String>]
      [-DeletedDateTime <DateTime>]
      [-Department <String>]
      [-DisplayName <String>]
      [-EmployeeHireDate <DateTime>]
      [-EmployeeId <String>]
      [-EmployeeType <String>]
      [-ExternalUserState <String>]
      [-ExternalUserStateChangeDateTime <DateTime>]
      [-FaxNumber <String>]
      [-GivenName <String>]
      [-Id <String>]
      [-Identity <IMicrosoftGraphObjectIdentity[]>]
      [-IsResourceAccount]
      [-JobTitle <String>]
      [-Mail <String>]
      [-MailNickname <String>]
      [-OfficeLocation <String>]
      [-OnPremisesImmutableId <String>]
      [-OtherMail <String[]>]
      [-PasswordPolicy <String>]
      [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
      [-PostalCode <String>]
      [-PreferredLanguage <String>]
      [-ShowInAddressList]
      [-State <String>]
      [-StreetAddress <String>]
      [-Surname <String>]
      [-UsageLocation <String>]
      [-UserType <String>]
      -InputObject <IMicrosoftGraphUser>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADUser
      [-AccountEnabled <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-AgeGroup <String>]
      [-City <String>]
      [-CompanyName <String>]
      [-ConsentProvidedForMinor <String>]
      [-Country <String>]
      [-DeletedDateTime <DateTime>]
      [-Department <String>]
      [-DisplayName <String>]
      [-EmployeeHireDate <DateTime>]
      [-EmployeeId <String>]
      [-EmployeeType <String>]
      [-ExternalUserState <String>]
      [-ExternalUserStateChangeDateTime <DateTime>]
      [-FaxNumber <String>]
      [-GivenName <String>]
      [-Id <String>]
      [-Identity <IMicrosoftGraphObjectIdentity[]>]
      [-IsResourceAccount]
      [-JobTitle <String>]
      [-Mail <String>]
      [-MailNickname <String>]
      [-OfficeLocation <String>]
      [-OnPremisesImmutableId <String>]
      [-OtherMail <String[]>]
      [-PasswordPolicy <String>]
      [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
      [-PostalCode <String>]
      [-PreferredLanguage <String>]
      [-ShowInAddressList]
      [-State <String>]
      [-StreetAddress <String>]
      [-Surname <String>]
      [-UsageLocation <String>]
      [-UserType <String>]
      -UserPrincipalName <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Aggiorna l'entità negli utenti

Esempio

Esempio 1: Aggiornare l'utente in base al nome dell'entità utente

Update-AzADUser -UPNOrObjectId $upn -City $city

Aggiornare l'utente in base al nome dell'entità utente

Parametri

-AccountEnabled

true per abilitare l'account; in caso contrario, false. Sempre true se combinato con -Password. -AccountEnabled $false viene ignorato quando si modifica la password dell'account.

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

-AgeGroup

Imposta il gruppo di età dell'utente. Valori consentiti: null, minor, notAdult e adult. Per altre informazioni, vedere le definizioni di proprietà del gruppo di età legale. Supporta $filter (eq, ne, NOT e in).

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

-City

Città in cui si trova l'utente. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-CompanyName

Nome della società associato all'utente. Questa proprietà può essere utile per descrivere l'azienda da cui proviene un utente esterno. La lunghezza massima del nome della società è di 64 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-ConsentProvidedForMinor

Imposta se il consenso è stato ottenuto per i minori. Valori consentiti: null, concesso, negato e notRequired. Per altre informazioni, vedere le definizioni di proprietà del gruppo di età legale. Supporta $filter (eq, ne, NOT e in).

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

-Country

Paese/area geografica in cui si trova l'utente; ad esempio Stati Uniti o Regno Unito. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:PSObject
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeletedDateTime

.

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

-Department

Nome del reparto in cui funziona l'utente. La lunghezza massima è di 64 caratteri. Supporta $filter (operatori eq, ne, NOT , ge, le e in).

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

-DisplayName

Nome visualizzato nella rubrica dell'utente. Questo valore è in genere la combinazione del nome dell'utente, dell'iniziale centrale e del cognome. Questa proprietà è obbligatoria quando viene creato un utente e non può essere cancellata durante gli aggiornamenti. La lunghezza massima è di 256 caratteri. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy e $search.

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

-EmployeeHireDate

Data e ora in cui l'utente è stato assunto o inizierà il lavoro in caso di assunzione futura. Supporta $filter (eq, ne, NOT , ge, le, in).

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

-EmployeeId

Identificatore del dipendente assegnato all'utente dall'organizzazione. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-EmployeeType

Acquisisce il tipo di lavoro aziendale. Ad esempio, Employee, Contractor, Consultant o Vendor. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-ExternalUserState

Per un utente esterno invitato al tenant usando l'API di invito, questa proprietà rappresenta lo stato di invito dell'utente invitato. Per gli utenti invitati, lo stato può essere PendingAcceptance o Accepted o Null per tutti gli altri utenti. Supporta $filter (eq, ne, NOT , in).

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

-ExternalUserStateChangeDateTime

Mostra il timestamp per la modifica più recente alla proprietà externalUserState. Supporta $filter (eq, ne, NOT , in).

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

-FaxNumber

Numero fax dell'utente. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-ForceChangePasswordNextLogin

Deve essere specificato se l'utente deve modificare la password al successivo accesso riuscito (true). Il comportamento predefinito è (false) per non modificare la password al successivo accesso riuscito.

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

-GivenName

Nome specificato (nome) dell'utente. La lunghezza massima è di 64 caratteri. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-Id

Sola lettura.

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

-Identity

Rappresenta le identità che possono essere usate per accedere a questo account utente. Un'identità può essere fornita da Microsoft (nota anche come account locale), da organizzazioni o da provider di identità di social networking come Facebook, Google e Microsoft e associato a un account utente. Può contenere più elementi con lo stesso valore signInType. Supporta $filter (eq) solo in cui signInType non è userPrincipalName. Per costruire, vedere la sezione NOTES per le proprietà IDENTITY e creare una tabella hash.

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

-InputObject

oggetto input utente

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

-IsResourceAccount

Non usare : riservato per uso futuro.

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

-JobTitle

Titolo di lavoro dell'utente. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-Mail

Indirizzo SMTP per l'utente, ad esempio, admin@contoso.com. Le modifiche apportate a questa proprietà aggiorneranno anche l'insieme proxyAddresses dell'utente in modo da includere il valore come indirizzo SMTP. Anche se questa proprietà può contenere caratteri accenti, l'uso può causare problemi di accesso con altre applicazioni Microsoft per l'utente. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

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

-MailNickname

Alias di posta elettronica per l'utente. Questa proprietà deve essere specificata quando viene creato un utente. La lunghezza massima è di 64 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-ObjectId

Nome dell'entità utente dell'utente da aggiornare.

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

-OfficeLocation

Posizione dell'ufficio nel luogo di lavoro dell'utente. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-OnPremisesImmutableId

Questa proprietà viene usata per associare un account utente di Active Directory locale all'oggetto utente di Azure AD. Questa proprietà deve essere specificata quando si crea un nuovo account utente in Graph se si usa un dominio federato per la proprietà userPrincipalName (UPN) dell'utente. NOTA: non è possibile utilizzare i caratteri $ e _ quando si specifica questa proprietà. Restituito solo in $select. Supporta $filter (eq, ne, NOT, ge, le, in)..

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

-OtherMail

Elenco di indirizzi di posta elettronica aggiuntivi per l'utente; ad esempio: ['bob@contoso.com', 'Robert@fabrikam.com']. NOTA: sebbene questa proprietà possa contenere caratteri accenti, può causare problemi di accesso alle applicazioni proprietarie per l'utente. Supporta $filter (eq, NOT, ge, le, in, startsWith).

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

-PassThru

Restituisce true quando il comando ha esito positivo

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

-Password

Password per l'utente. Questa proprietà è obbligatoria quando viene creato un utente.

Può essere aggiornato, ma l'utente dovrà modificare la password al successivo account di accesso.

La password deve soddisfare i requisiti minimi specificati./fied dalla proprietà passwordPolicies dell'utente. Per impostazione predefinita, è necessaria una password complessa. Quando si modifica la password usando questo metodo, AccountEnabled è impostato su true.

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

-PasswordPolicy

Specifica i criteri password per l'utente. Questo valore è un'enumerazione con un valore possibile, disableStrongPassword, che consente di specificare password più deboli rispetto ai criteri predefiniti. È anche possibile specificare DisablePasswordExpiration. I due possono essere specificati insieme; ad esempio: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

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

-PasswordProfile

passwordProfile Per costruire, vedere la sezione NOTES per le proprietà PASSWORDPROFILE e creare una tabella hash.

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

-PostalCode

Codice postale per l'indirizzo postale dell'utente. Il codice postale è specifico del paese/area geografica dell'utente. Negli Stati Uniti d'America questo attributo contiene il codice POSTALE. La lunghezza massima è di 40 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-PreferredLanguage

Lingua preferita per l'utente. Deve seguire il codice ISO 639-1; ad esempio en-US. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-ShowInAddressList

true se l'elenco indirizzi globale di Outlook deve contenere l'utente, in caso contrario false. Se non è impostato, verrà considerato true. Per gli utenti invitati tramite gestione inviti, questa proprietà verrà impostata su false. Supporta $filter (eq, ne, NOT, in).

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

-State

Stato o provincia nell'indirizzo dell'utente. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-StreetAddress

Indirizzo dell'ufficio dell'utente. La lunghezza massima è di 1024 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-Surname

Cognome dell'utente (nome della famiglia o cognome). La lunghezza massima è di 64 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-UPNOrObjectId

Nome dell'entità utente o ID oggetto dell'utente da aggiornare.

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

-UsageLocation

Codice paese a due lettere (standard ISO 3166). Obbligatorio per gli utenti a cui verranno assegnate le licenze a causa del requisito legale di verificare la disponibilità dei servizi nei paesi. Gli esempi includono: US, JP e GB. Non nullable. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-UserPrincipalName

Nome dell'entità utente (UPN) dell'utente. L'UPN è un nome di accesso in stile Internet per l'utente basato sullo standard Internet RFC 822. Per convenzione, deve essere eseguito il mapping al nome di posta elettronica dell'utente. Il formato generale è alias@domain, dove il dominio deve essere presente nella raccolta di domini verificati del tenant. Questa proprietà è obbligatoria quando viene creato un utente. È possibile accedere ai domini verificati per il tenant dalla proprietà verifiedDomains dell'organizzazione. NOTA: sebbene questa proprietà possa contenere caratteri accenti, può causare problemi di accesso alle applicazioni proprietarie per l'utente. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) e $orderBy.

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

-UserType

Valore stringa che può essere usato per classificare i tipi di utente nella directory, ad esempio Membro e Guest. Supporta $filter (eq, ne, NOT, in, ).

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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

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

Input

IMicrosoftGraphUser

Output

Boolean

Note

ALIAS

Set-AzADUser