New-AzIotHubSasToken
Wygeneruj token SAS dla docelowego centrum IoT Hub, urządzenia lub modułu.
Składnia
New-AzIotHubSasToken
[-ResourceGroupName] <String>
[-IotHubName] <String>
[-DeviceId <String>]
[-ModuleId <String>]
[-KeyName <String>]
[-KeyType <PSKeyType>]
[-Duration <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzIotHubSasToken
[-InputObject] <PSIotHub>
[-DeviceId <String>]
[-ModuleId <String>]
[-KeyName <String>]
[-KeyType <PSKeyType>]
[-Duration <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzIotHubSasToken
[-ResourceId] <String>
[-DeviceId <String>]
[-ModuleId <String>]
[-KeyName <String>]
[-KeyType <PSKeyType>]
[-Duration <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
W przypadku tokenów SAS urządzenia parametr zasad jest używany tylko do uzyskiwania dostępu do rejestru urządzeń. W związku z tym zasady powinny mieć dostęp do odczytu do rejestru. W przypadku tokenów usługi IoT Hub zasady są częścią sygnatury dostępu współdzielonego.
Przykłady
Przykład 1
New-AzIotHubSasToken -ResourceGroupName "myresourcegroup" -IotHubName "myiothub"
Wygeneruj token SAS usługi IoT Hub przy użyciu zasad i klucza podstawowego usługi iothubowner.
Przykład 2
New-AzIotHubSasToken -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -KeyName "registryRead" -KeyType "secondary"
Wygeneruj token SAS usługi IoT Hub przy użyciu zasad registryRead i klucza pomocniczego.
Przykład 3
New-AzIotHubSasToken -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1"
Wygeneruj token SAS urządzenia przy użyciu zasad iothubowner, aby uzyskać dostęp do rejestru urządzeń {iothub_name}.
Przykład 4
New-AzIotHubSasToken -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -ModuleId "myModule1"
Wygeneruj token SAS modułu przy użyciu zasad iothubowner w celu uzyskania dostępu do rejestru urządzeń {iothub_name}.
Parametry
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DeviceId
Identyfikator urządzenia docelowego.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Duration
Przyszłe wygaśnięcie (w sekundach) tokenu do wygenerowania. Wartość domyślna to 3600.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InputObject
Obiekt IotHub
Typ: | PSIotHub |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-IotHubName
Nazwa centrum Iot Hub
Typ: | String |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-KeyName
Nazwa klucza dostępu.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-KeyType
Typ klucza dostępu.
Typ: | PSKeyType |
Dopuszczalne wartości: | primary, secondary |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ModuleId
Identyfikator modułu docelowego.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Nazwa grupy zasobów
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResourceId
Identyfikator zasobu usługi IotHub
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |