Set-EntraDevice

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Atualiza um dispositivo.

Sintaxe

Default (Default) 

Set-EntraDevice

    -DeviceObjectId <String>
    [-DevicePhysicalIds <System.Collections.Generic.List`1[String]>]
    [-DeviceOSType <String>]
    [-DeviceTrustType <String>]
    [-DisplayName <String>]
    [-DeviceMetadata <String>]
    [-ApproximateLastLogonTimeStamp <DateTime>]
    [-AccountEnabled <Boolean>]
    [-DeviceId <String>]
    [-DeviceObjectVersion <Int32>]
    [-IsCompliant <Boolean>]
    [-DeviceOSVersion <String>]
    [-AlternativeSecurityIds <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.AlternativeSecurityId]>]
    [-ProfileType <String>]
    [-SystemLabels <System.Collections.Generic.List`1[String]>]
    [<CommonParameters>]

Description

O Set-EntraDevice cmdlet atualiza um dispositivo em Microsoft Entra ID.

O usuário de chamada deve ter pelo menos:

  • Função administrador do Intune
  • A função administrador de dispositivo de nuvem só pode habilitar ou desabilitar dispositivos
  • Windows 365 função de Administrador só pode atualizar as propriedades básicas do dispositivo.

Exemplos

Exemplo 1: atualizar um nome de exibição do dispositivo

Connect-Entra -Scopes 'Directory.AccessAsUser.All', 'Device.ReadWrite.All'
$device = Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"
Set-EntraDevice -DeviceObjectId $device.ObjectId -DisplayName 'My OS/2 computer'

Este exemplo mostra como atualizar um nome de exibição de um especificado.

Exemplo 2: atualizar uma ID de segurança alternativa do dispositivo

Connect-Entra -Scopes 'Directory.AccessAsUser.All', 'Device.ReadWrite.All'
$newId = New-Object Microsoft.Open.AzureAD.Model.AlternativeSecurityId
$newId.Key = [System.Text.Encoding]::UTF8.GetBytes('test')
$newId.type = 2
$device = Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"
Set-EntraDevice -DeviceObjectId $device.ObjectId -AlternativeSecurityIds $newId

Este exemplo mostra como atualizar uma ID de segurança alternativa de um dispositivo especificado.

Exemplo 3: atualizar uma conta de dispositivo habilitada

Connect-Entra -Scopes 'Directory.AccessAsUser.All', 'Device.ReadWrite.All'
$device = Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"
Set-EntraDevice -DeviceObjectId $device.ObjectId -AccountEnabled $true

Este exemplo mostra como atualizar uma conta habilitada de um dispositivo especificado.

Exemplo 4: Atualizar um tipo de sistema operacional do dispositivo

Connect-Entra -Scopes 'Directory.AccessAsUser.All', 'Device.ReadWrite.All'
$device = Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"
Set-EntraDevice -DeviceObjectId $device.ObjectId -DeviceOSType Windows

Este exemplo mostra como atualizar um tipo de sistema operacional de um dispositivo especificado.

Exemplo 5: Atualizar um dispositivo

Connect-Entra -Scopes 'Directory.AccessAsUser.All', 'Device.ReadWrite.All'
$device = Get-EntraDevice -Filter "DisplayName eq 'Woodgrove Desktop'"
$params = @{
    DeviceObjectId      = $device.ObjectId
    DeviceMetadata      = 'Testdevice'
    DeviceObjectVersion = 4
    DevicePhysicalIds   = '[GID]:g:1234567890123456'
    IsCompliant         = $false
}
Set-EntraDevice @params

Este exemplo mostra como atualizar várias propriedades de um dispositivo especificado.

Parâmetros

-AccountEnabled

Indica se a conta está habilitada.

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

-AlternativeSecurityIds

Especifica IDs de segurança alternativas.

Propriedades do parâmetro

Tipo:

System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.AlternativeSecurityId]

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

-ApproximateLastLogonTimeStamp

O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2014 é 2014-01-01T00:00:00Z. Somente leitura. Dá suporte a $filter (eq, ne, not, ge, le e eq em valores nulos) e $orderby.

Propriedades do parâmetro

Tipo:System.DateTime
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

-DeviceId

Especifica a ID do dispositivo.

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:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DeviceMetadata

Os metadados do dispositivo para este dispositivo.

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:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DeviceObjectId

Especifica a ID de objeto de um dispositivo em Microsoft Entra ID.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-DeviceObjectVersion

Especifica a versão do objeto do dispositivo.

Propriedades do parâmetro

Tipo:System.Int32
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

-DeviceOSType

Especifica o sistema operacional.

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:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DeviceOSVersion

Especifica a versão do sistema operacional.

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:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DevicePhysicalIds

Especifica a ID física.

Propriedades do parâmetro

Tipo:

System.Collections.Generic.List`1[System.String]

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

-DeviceTrustType

Especifica o tipo de confiança do dispositivo.

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:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisplayName

Especifica o nome de exibição.

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:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IsCompliant

Indica se o dispositivo está em conformidade.

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

-IsManaged

Indica se o dispositivo é gerenciado.

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

-ProfileType

Especifica o tipo de perfil do dispositivo. Valores possíveis: RegisteredDevice (padrão), SecureVM, Printer, Shared, IoT.

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:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SystemLabels

Especifica a lista de rótulos aplicados ao dispositivo pelo sistema.

Propriedades do parâmetro

Tipo:

System.Collections.Generic.List`1[System.String]

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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.