Set-EntraDevice

Modulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Aggiorna un dispositivo.

Sintassi

Default (Impostazione predefinita) 

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>]

Descrizione

Il Set-EntraDevice cmdlet aggiorna un dispositivo in Microsoft Entra ID.

L'utente chiamante deve avere almeno:

  • Ruolo di amministratore di Intune
  • Il ruolo Amministratore dispositivi cloud può abilitare o disabilitare solo i dispositivi
  • Windows 365 ruolo Amministratore può aggiornare solo le proprietà di base del dispositivo.

Esempio

Esempio 1: Aggiornare un nome visualizzato del 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'

In questo esempio viene illustrato come aggiornare un nome visualizzato di un oggetto specificato.

Esempio 2: Aggiornare un ID di sicurezza alternativo del 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

Questo esempio illustra come aggiornare un ID di sicurezza alternativo di un dispositivo specificato.

Esempio 3: Aggiornare un account del dispositivo abilitato

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

Questo esempio illustra come aggiornare un account abilitato per un dispositivo specificato.

Esempio 4: Aggiornare un tipo di sistema operativo del 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

Questo esempio illustra come aggiornare un tipo di sistema operativo di un dispositivo specificato.

Esempio 5: Aggiornare un 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

Questo esempio illustra come aggiornare più proprietà di un dispositivo specificato.

Parametri

-AccountEnabled

Indica se l'account è abilitato.

Proprietà dei parametri

Tipo:System.Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AlternativeSecurityIds

Specifica ID di sicurezza alternativi.

Proprietà dei parametri

Tipo:

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

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ApproximateLastLogonTimeStamp

Il tipo timestamp rappresenta le informazioni di data e ora usando il formato ISO 8601 ed è sempre in formato UTC. Ad esempio, mezzanotte UTC il 1 gennaio 2014 è 2014-01-01T00:00:00Z. Di sola lettura. Supporta $filter (eq, ne, not, ge, le eq in valori Null) e $orderby.

Proprietà dei parametri

Tipo:System.DateTime
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DeviceId

Specifica l'ID dispositivo.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DeviceMetadata

Metadati del dispositivo per questo dispositivo.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DeviceObjectId

Specifica l'ID oggetto di un dispositivo in Microsoft Entra ID.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ObjectId

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DeviceObjectVersion

Specifica la versione dell'oggetto del dispositivo.

Proprietà dei parametri

Tipo:System.Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DeviceOSType

Specifica il sistema operativo.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DeviceOSVersion

Specifica la versione del sistema operativo.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DevicePhysicalIds

Specifica l'ID fisico.

Proprietà dei parametri

Tipo:

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

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DeviceTrustType

Specifica il tipo di attendibilità del dispositivo.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DisplayName

Specifica il nome visualizzato.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IsCompliant

Indica se il dispositivo è conforme.

Proprietà dei parametri

Tipo:System.Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IsManaged

Indica se il dispositivo è gestito.

Proprietà dei parametri

Tipo:System.Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ProfileType

Specifica il tipo di profilo del dispositivo. Valori possibili: RegisteredDevice (impostazione predefinita), SecureVM, Printer, Shared, IoT.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SystemLabels

Specifica l'elenco di etichette applicate al dispositivo dal sistema.

Proprietà dei parametri

Tipo:

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

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.