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

この例では、指定したデバイスの代替セキュリティ ID を更新する方法を示します。

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

この例では、指定したデバイスの OS の種類を更新する方法を示します。

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

この例では、指定したデバイスの複数のプロパティを更新する方法を示します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。