New-EntraDevice

New-EntraDevice

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

New-EntraDevice コマンドレットは、Microsoft Entra IDにデバイスを作成します。

職場または学校アカウントを含む委任されたシナリオでは、サインインしているユーザーは、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールを持っている必要があります。 この操作では、次の最小特権ロールがサポートされています。

• Intune 管理者
• Windows 365 管理者

Connect-Entra -Scopes 'Directory.AccessAsUser.All', 'Device.ReadWrite.All'
$guid = [guid]::NewGuid()
$newId = New-Object Microsoft.Open.AzureAD.Model.AlternativeSecurityId
$newId.Key = [System.Text.Encoding]::UTF8.GetBytes('test')
$newId.type = 2
$params = @{
    AccountEnabled         = $true
    DisplayName            = 'My new device'
    AlternativeSecurityIds = $newId
    DeviceId               = $guid
    DeviceOSType           = 'OS/2'
    DeviceOSVersion        = '9.3'
}
New-EntraDevice @params

ObjectId                             DeviceId                             DisplayName
--------                             --------                             -----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb dddddddd-3333-4444-5555-eeeeeeeeeeee My new device

このコマンドを実行すると、新しいデバイスが作成されます。

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