Set-EntraDevice

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

Met à jour un appareil.

Syntaxe

Default (Par défaut) 

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

L’applet Set-EntraDevice de commande met à jour un appareil dans Microsoft Entra ID.

L’utilisateur appelant doit avoir au moins :

  • Rôle Administrateur Intune
  • Le rôle Administrateur d’appareil cloud ne peut activer ou désactiver que les appareils
  • Windows 365 rôle Administrateur ne peut mettre à jour que les propriétés d’appareil de base.

Exemples

Exemple 1 : Mettre à jour un nom d’affichage d’appareil

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'

Cet exemple montre comment mettre à jour un nom d’affichage d’un spécifié.

Exemple 2 : Mettre à jour un ID de sécurité de remplacement d’appareil

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

Cet exemple montre comment mettre à jour un AUTRE ID de sécurité d’un appareil spécifié.

Exemple 3 : Mettre à jour un compte d’appareil activé

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

Cet exemple montre comment mettre à jour un compte activé d’un appareil spécifié.

Exemple 4 : Mettre à jour un type de système d’exploitation d’appareil

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

Cet exemple montre comment mettre à jour un type de système d’exploitation d’un appareil spécifié.

Exemple 5 : Mettre à jour un appareil

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

Cet exemple montre comment mettre à jour plusieurs propriétés d’un appareil spécifié.

Paramètres

-AccountEnabled

Indique si le compte est activé.

Propriétés du paramètre

Type:System.Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AlternativeSecurityIds

Spécifie d’autres ID de sécurité.

Propriétés du paramètre

Type:

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

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ApproximateLastLogonTimeStamp

Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours en heure UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z. Lecture seule. Prend en charge $filter (eq, ne, not, ge, le et eq sur les valeurs Null) et $orderby.

Propriétés du paramètre

Type:System.DateTime
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeviceId

Spécifie l’ID de l’appareil.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeviceMetadata

Métadonnées de l’appareil pour cet appareil.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeviceObjectId

Spécifie l’ID d’objet d’un appareil dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId)

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DeviceObjectVersion

Spécifie la version d’objet de l’appareil.

Propriétés du paramètre

Type:System.Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeviceOSType

Spécifie le système d’exploitation.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeviceOSVersion

Spécifie la version du système d’exploitation.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DevicePhysicalIds

Spécifie l’ID physique.

Propriétés du paramètre

Type:

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

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeviceTrustType

Spécifie le type d’approbation d’appareil.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisplayName

Spécifie le nom complet.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IsCompliant

Indique si l’appareil est conforme.

Propriétés du paramètre

Type:System.Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IsManaged

Indique si l’appareil est géré.

Propriétés du paramètre

Type:System.Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProfileType

Spécifie le type de profil de l’appareil. Valeurs possibles : RegisteredDevice (valeur par défaut), SecureVM, Printer, Shared, IoT.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SystemLabels

Spécifie la liste des étiquettes appliquées à l’appareil par le système.

Propriétés du paramètre

Type:

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

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.