Get-MsolDevice
Ottiene un singolo dispositivo o un elenco di dispositivi.
Sintassi
Get-MsolDevice
-Name <String>
[<CommonParameters>]
Get-MsolDevice
[-All]
[-ReturnRegisteredOwners]
[<CommonParameters>]
Get-MsolDevice
-DeviceId <Guid>
[<CommonParameters>]
Get-MsolDevice
-All
-LogonTimeBefore <DateTime>
[<CommonParameters>]
Get-MsolDevice
-ObjectId <Guid>
[<CommonParameters>]
Get-MsolDevice
-RegisteredOwnerUpn <String>
[<CommonParameters>]
Get-MsolDevice
-All
-IncludeSystemManagedDevices
[<CommonParameters>]
Descrizione
Il cmdlet Get-MsolDevice ottiene un singolo dispositivo o un elenco di dispositivi.
Esempio
Esempio 1: Ottenere un oggetto dispositivo
PS C:\>Get-MsolDevice -Name "NIC0123"
Questo comando ottiene un oggetto dispositivo denominato NIC0123.
Esempio 2: Ottenere un elenco di oggetti dispositivo
PS C:\>Get-MsolDevice -All
Questo comando ottiene un elenco di oggetti dispositivo. Poiché il parametro ReturnRegisteredOwners non viene usato, l'oggetto device non contiene la proprietà registeredOwners .
Esempio 3: Ottenere un elenco di oggetti dispositivo che contengono la proprietà registeredOwners
PS C:\>Get-MsolDevice -All -ReturnRegisteredOwners
Questo comando ottiene un elenco di oggetti dispositivo. Poiché viene usato il parametro ReturnRegisteredOwners , l'oggetto device contiene la proprietà registeredOwners .
Esempio 4: Ottenere un dispositivo in base all'ID dispositivo
PS C:\>Get-MsolDevice -DeviceId "1aa200c4-bdfb-42b5-9a1e-5f1bafbe4274"
Questo comando ottiene un dispositivo con l'ID dispositivo corrispondente.
Esempio 5: Ottenere un oggetto dispositivo in base all'ID oggetto
PS C:\>Get-MsolDevice -ObjectId "566F7EA7-7BF1-4F4A-AF23-A1B46DBD46D6"
Questo comando ottiene un dispositivo con l'ID oggetto corrispondente.
Esempio 6: Ottenere i dispositivi registrati da UPN
PS C:\>Get-MsolDevice -RegisteredOwnerUpn "pattifuller@contoso.com"
Questo comando ottiene tutti i dispositivi registrati dall'utente con l'UPN denominato pattifuller@contoso.com.
Esempio 7: Ottenere il timestamp del dispositivo per attività (accesso)
PS C:\>Get-MsolDevice -All -LogonTimeBefore 'January 1, 2017 12:00:00 AM'
Il comando Ths ottiene tutti i dispositivi con Il valore ApproximateLastLogonTimestamp prima del 1° gennaio 2017
Esempio 8: Ottenere i dispositivi e includere i dispositivi gestiti dal sistema
PS C:\>Get-MsolDevice -All -IncludeSystemManagedDevices
Questo comando ottiene tutti i dispositivi e include dispositivi pilota automatici e altri dispositivi usati con Intune (ad esempio EAS)
Parametri
-All
Indica che questo cmdlet restituisce tutti i risultati.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceId
Specifica l'ID dispositivo del dispositivo che ottiene questo cmdlet.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IncludeSystemManagedDevices
Indica che questo cmdlet include dispositivi gestiti dal sistema, ad esempio il pilota automatico.
Type: | SwitchParamater |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LogonTimeBefore
Specificato la data (UTC) usata per filtrare l'elenco dei dispositivi in base.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifica il nome visualizzato del dispositivo che ottiene questo cmdlet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ObjectId
Specifica l'ID oggetto univoco del dispositivo che ottiene questo cmdlet.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RegisteredOwnerUpn
Specifica l'oggetto utente che è il proprietario registrato del dispositivo. È necessario specificare il nome dell'entità utente (UPN) o ObjectId oppure passare un'istanza di un oggetto Microsoft.Online.Administration.User contenente l'UPN o ObjectId dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReturnRegisteredOwners
Indica che questo cmdlet restituisce la proprietà registeredOwners del dispositivo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Output
Microsoft.Online.Administration.Device
Questo cmdlet restituisce oggetti dispositivo, che includono le informazioni seguenti:
- AccountEnabled: stato del dispositivo: abilitato o disabilitato.
- ObjectId: ID univoco del dispositivo.
- DeviceId: ID dispositivo del dispositivo.
- DisplayName: nome visualizzato del dispositivo.
- DeviceObjectVersion: numero di versione dell'oggetto del dispositivo.
- DeviceOSType: tipo di sistema operativo del dispositivo.
- DeviceOSVersion: numero di versione del sistema operativo del dispositivo.
- DeviceTrustType: tipo di attendibilità del dispositivo. Il valore potrebbe essere uno dei seguenti: Workplace Join, AzureAD Join, Domain Join.
- DeviceTrustLevel: livello di attendibilità del dispositivo. Il valore potrebbe essere uno dei seguenti: Autenticato, Conforme, Gestito.
- DevicePhysicalIds: ID fisici del dispositivo.
- ApprossimazioneLastLogonTimestamp: l'ultimo timestamp di accesso usando questo dispositivo.
- AlternativeSecurityIds: ID di sicurezza alternativi del dispositivo.
- DirSyncEnabled: se il dispositivo è abilitato con DirSync.
- LastDirSyncTime: l'ultimo timestamp del dispositivo è stato sincronizzato da DirSync.
- RegisteredOwners: proprietario registrato del dispositivo.
- GraphDeviceObject: oggetto dispositivo restituito dall'API graph.
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per