Set-SPOUser

Módulo:
Microsoft.Online.SharePoint.PowerShell Module

Configura propriedades em um usuário existente.

Sintaxe

Default (Default) 

Set-SPOUser
    -Site <SpoSitePipeBind>
    -LoginName <String>
    [-IsSiteCollectionAdmin <Boolean>]
    [-UpdateUserTypeFromAzureAD]
    [<CommonParameters>]

Description

Use o cmdlet Set-SPOUser para configurar as propriedades de um usuário existente. Isto é, para adicionar ou remover um usuário como um administrador de conjunto de sites do SharePoint Online.

Você deve ser pelo menos um administrador do SharePoint para executar o cmdlet.

Para obter permissões e as informações mais recentes sobre o Windows PowerShell do SharePoint Online, consulte a documentação on-line em Introdução ao Shell de gerenciamento do SharePoint Online..

Este cmdlet não é suportado para uso com GDAP (privilégios de administrador delegado granular).

Exemplos

Exemplo 1

Set-SPOUser -Site https://contoso.sharepoint.com/sites/marketing -LoginName melissa.kerr@contoso.com -IsSiteCollectionAdmin $true

Este exemplo torna melissa.kerr@contoso.com um administrador de conjunto de sites do SharePoint Online em https://contoso.sharepoint.com/sites/marketing.

Exemplo 2

Set-SPOUser -Site https://contoso.sharepoint.com/sites/benefits -LoginName adelev_fabrikam.onmicrosoft.com#ext#@contoso.onmicrosoft.com -IsSiteCollectionAdmin $true

Este exemplo torna o usuário convidado adelev_fabrikam.onmicrosoft.com administrador de conjunto de sites do SharePoint Online no https://contoso.sharepoint.com/sites/benefits.

Parâmetros

-IsSiteCollectionAdmin

Aplicável: SharePoint Online

Especifica se o usuário é um administrador de conjunto de sites.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LoginName

Aplicável: SharePoint Online

Especifica o nome de usuário.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Site

Aplicável: SharePoint Online

Especifica a URL completa do conjunto de sites. Deve ser um caminho gerenciado válido no site da empresa.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UpdateUserTypeFromAzureAD

Se a propriedade UserType de um usuário existente for alterada no Microsoft Entra ID de Membro para Convidado ou vice-versa, esse parâmetro poderá ser usado para atualizá-lo no SharePoint Online. Para obter mais informações, confira Converter UserType.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.