Set-EntraDevice

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

該指令長在 Set-EntraDevice Microsoft Entra ID 中更新裝置。

呼叫使用者至少必須具備：

• Intune 管理員角色
• 雲端裝置管理員角色只能啟用或停用裝置
• Windows 365 管理員角色只能更新基本的裝置屬性。

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'

這個範例展示了如何更新指定顯示名稱。

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

此範例展示了如何更新指定裝置的替代安全識別碼。

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

這個範例展示了如何更新指定裝置啟用的帳號。

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

此範例展示了如何更新指定裝置的作業系統類型。

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

這個範例展示了如何更新指定裝置的多個屬性。

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。