Merge pull request #225926 from MicrosoftDocs/main

2/01 OOB publish at 9AM

Author: huypub

.openpublishing.redirection.virtual-desktop.json

@@ -129,6 +129,11 @@
             "source_path_from_root": "/articles/virtual-desktop/deploy-windows-7-virtual-machine.md",
             "redirect_url": "/azure/virtual-desktop/deploy-windows-server-virtual-machine",
             "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/powershell-module.md",
+            "redirect_url": "/azure/virtual-desktop/cli-powershell",
+            "redirect_document_id": true
         }
     ]
 }

articles/active-directory/authentication/how-to-mfa-number-match.md

@@ -201,7 +201,8 @@ The `context` variable is implicitly available in every policy [expression](api-
 |----------------------|-------------------------------------------------------|
 |`context`|[`Api`](#ref-context-api): [`IApi`](#ref-iapi)<br /><br /> [`Deployment`](#ref-context-deployment)<br /><br /> Elapsed: `TimeSpan` - time interval between the value of `Timestamp` and current time<br /><br /> [`LastError`](#ref-context-lasterror)<br /><br /> [`Operation`](#ref-context-operation)<br /><br /> [`Product`](#ref-context-product)<br /><br /> [`Request`](#ref-context-request)<br /><br /> `RequestId`: `Guid` - unique request identifier<br /><br /> [`Response`](#ref-context-response)<br /><br /> [`Subscription`](#ref-context-subscription)<br /><br /> `Timestamp`: `DateTime` - point in time when request was received<br /><br /> `Tracing`: `bool` - indicates if tracing is on or off <br /><br /> [User](#ref-context-user)<br /><br /> [`Variables`](#ref-context-variables): `IReadOnlyDictionary<string, object>`<br /><br /> `void Trace(message: string)`|
 |<a id="ref-context-api"></a>`context.Api`|`Id`: `string`<br /><br /> `IsCurrentRevision`: `bool`<br /><br />  `Name`: `string`<br /><br /> `Path`: `string`<br /><br /> `Revision`: `string`<br /><br /> `ServiceUrl`: [`IUrl`](#ref-iurl)<br /><br /> `Version`: `string` |
-|<a id="ref-context-deployment"></a>`context.Deployment`|`GatewayId`: `string` (returns 'managed' for managed gateways)<br /><br /> `Region`: `string`<br /><br /> `ServiceId`: `string`<br /><br /> `ServiceName`: `string`<br /><br /> `Certificates`: `IReadOnlyDictionary<string, X509Certificate2>`|
+|<a id="ref-context-deployment"></a>`context.Deployment`|[`Gateway`](#ref-context-gateway)<br /><br /> `GatewayId`: `string` (returns 'managed' for managed gateways)<br /><br /> `Region`: `string`<br /><br /> `ServiceId`: `string`<br /><br /> `ServiceName`: `string`<br /><br /> `Certificates`: `IReadOnlyDictionary<string, X509Certificate2>`|
+|<a id="ref-context-gateway"></a>`context.Deployment.Gateway`|`Id`: `string` (returns 'managed' for managed gateways)<br /><br /> `InstanceId`: `string` (returns 'managed' for managed gateways)<br /><br /> `IsManaged`: `bool`|
 |<a id="ref-context-lasterror"></a>`context.LastError`|`Source`: `string`<br /><br /> `Reason`: `string`<br /><br /> `Message`: `string`<br /><br /> `Scope`: `string`<br /><br /> `Section`: `string`<br /><br /> `Path`: `string`<br /><br /> `PolicyId`: `string`<br /><br /> For more information about `context.LastError`, see [Error handling](api-management-error-handling-policies.md).|
 |<a id="ref-context-operation"></a>`context.Operation`|`Id`: `string`<br /><br /> `Method`: `string`<br /><br /> `Name`: `string`<br /><br /> `UrlTemplate`: `string`|
 |<a id="ref-context-product"></a>`context.Product`|`Apis`: `IEnumerable<`[`IApi`](#ref-iapi)`>`<br /><br /> `ApprovalRequired`: `bool`<br /><br /> `Groups`: `IEnumerable<`[`IGroup`](#ref-igroup)`>`<br /><br /> `Id`: `string`<br /><br /> `Name`: `string`<br /><br /> `State`: `enum ProductState {NotPublished, Published}`<br /><br /> `SubscriptionLimit`: `int?`<br /><br /> `SubscriptionRequired`: `bool`|

articles/active-directory/authentication/media/how-to-mfa-number-match/notifications-through-mobile-app.png

@@ -26,7 +26,7 @@ To create your first function in the new v2 model, see one of these quickstart a
 + [Get started with Visual Studio](./create-first-function-vs-code-python.md)
 + [Get started command prompt](./create-first-function-cli-python.md)
 
-## Blob trigger
+## Azure Blob storage trigger
 
 The following code snippet defines a function triggered from Azure Blob Storage:
 
@@ -36,13 +36,49 @@ import azure.functions as func
 app = func.FunctionApp()
 @app.function_name(name="BlobTrigger1")
 @app.blob_trigger(arg_name="myblob", path="samples-workitems/{name}",
-                  connection="<STORAGE_CONNECTION_SETTING>")
+                  connection="AzureWebJobsStorage")
 def test_function(myblob: func.InputStream):
    logging.info(f"Python blob trigger function processed blob \n"
                 f"Name: {myblob.name}\n"
                 f"Blob Size: {myblob.length} bytes")
 ```
 
+## Azure Blob storage input binding
+
+```python
+import logging
+import azure.functions as func
+app = func.FunctionApp()
+@app.function_name(name="BlobInput1")
+@app.route(route="file")
+@app.blob_input(arg_name="inputblob",
+                path="sample-workitems/{name}",
+                connection="AzureWebJobsStorage")
+def test(req: func.HttpRequest, inputblob: bytes) -> func.HttpResponse:
+    logging.info(f'Python Queue trigger function processed {len(inputblob)} bytes')
+    return inputblob
+```
+
+## Azure Blob storage output binding
+
+```python
+import logging
+import azure.functions as func
+app = func.FunctionApp()
+@app.function_name(name="BlobOutput1")
+@app.route(route="file")
+@app.blob_input(arg_name="inputblob",
+                path="sample-workitems/test.txt",
+                connection="AzureWebJobsStorage")
+@app.blob_output(arg_name="outputblob",
+                path="newblob/test.txt",
+                connection="AzureWebJobsStorage")
+def main(req: func.HttpRequest, inputblob: str, outputblob: func.Out[str]):
+    logging.info(f'Python Queue trigger function processed {len(inputblob)} bytes')
+    outputblob.set(inputblob)
+    return "ok"
+```
+
 ## Azure Cosmos DB trigger
 
 The following code snippet defines a function triggered from an Azure Cosmos DB (SQL API):
@@ -52,13 +88,45 @@ import logging
 import azure.functions as func
 app = func.FunctionApp()
 @app.function_name(name="CosmosDBTrigger1")
-@app.cosmos_db_trigger(arg_name="documents", database_name="<DB_NAME>", collection_name="<COLLECTION_NAME>", connection_string_setting="<COSMOS_CONNECTION_SETTING>",
+@app.cosmos_db_trigger(arg_name="documents", database_name="<DB_NAME>", collection_name="<COLLECTION_NAME>", connection_string_setting=""AzureWebJobsStorage"",
  lease_collection_name="leases", create_lease_collection_if_not_exists="true")
 def test_function(documents: func.DocumentList) -> str:
     if documents:
         logging.info('Document id: %s', documents[0]['id'])
 ```
 
+## Azure Cosmos DB input binding
+
+```python
+import logging
+import azure.functions as func
+app = func.FunctionApp()
+@app.route()
+@app.cosmos_db_input(
+    arg_name="documents", database_name="<DB_NAME>",
+    collection_name="<COLLECTION_NAME>",
+    connection_string_setting="AzureWebJobsStorage")
+def cosmosdb_input(req: func.HttpRequest, documents: func.DocumentList) -> str:
+    return func.HttpResponse(documents[0].to_json())
+```
+
+## Azure Cosmos DB output binding
+
+```python
+import logging
+import azure.functions as func
+@app.route()
+@app.cosmos_db_output(
+    arg_name="documents", database_name="<DB_NAME>",
+    collection_name="<COLLECTION_NAME>",
+    create_if_not_exists=True,
+    connection_string_setting="AzureWebJobsStorage")
+def main(req: func.HttpRequest, documents: func.Out[func.Document]) -> func.HttpResponse:
+    request_body = req.get_body()
+    documents.set(func.Document.from_json(request_body))
+    return 'OK'
+```
+
 ## Azure EventHub trigger
 
 The following code snippet defines a function triggered from an event hub instance:
@@ -69,12 +137,32 @@ import azure.functions as func
 app = func.FunctionApp()
 @app.function_name(name="EventHubTrigger1")
 @app.event_hub_message_trigger(arg_name="myhub", event_hub_name="samples-workitems",
-                               connection="<EVENT_HUB_CONNECTION_SETTING>") 
+                               connection=""AzureWebJobsStorage"") 
 def test_function(myhub: func.EventHubEvent):
     logging.info('Python EventHub trigger processed an event: %s',
                 myhub.get_body().decode('utf-8'))
 ```
 
+## Azure EventHub output binding
+
+```python
+import logging
+import azure.functions as func
+app = func.FunctionApp()
+@app.function_name(name="eventhub_output")
+@app.route(route="eventhub_output")
+@app.event_hub_output(arg_name="event",
+                      event_hub_name="samples-workitems",
+                      connection="AzureWebJobsStorage")
+def eventhub_output(req: func.HttpRequest, event: func.Out[str]):
+    body = req.get_body()
+    if body is not None:
+        event.set(body.decode('utf-8'))
+    else:    
+        logging.info('req body is none')
+    return 'ok'
+```
+
 ## HTTP trigger
 
 The following code snippet defines an HTTP triggered function:
@@ -104,28 +192,45 @@ def test_function(req: func.HttpRequest) -> func.HttpResponse:
         )
 ```
 
-## Azure Queue Storage trigger
+## Azure Queue storage trigger
 
 ```python
 import logging
 import azure.functions as func
 app = func.FunctionApp()
 @app.function_name(name="QueueTrigger1")
 @app.queue_trigger(arg_name="msg", queue_name="python-queue-items",
-                   connection="")  
+                   connection=""AzureWebJobsStorage"")  
 def test_function(msg: func.QueueMessage):
     logging.info('Python EventHub trigger processed an event: %s',
                  msg.get_body().decode('utf-8'))
 ```
 
+## Azure Queue storage output binding
+
+```python
+import logging
+import azure.functions as func
+app = func.FunctionApp()
+@app.function_name(name="QueueOutput1")
+@app.route(route="message")
+@app.queue_output(arg_name="msg", queue_name="python-queue-items", connection="AzureWebJobsStorage")
+def main(req: func.HttpRequest, msg: func.Out[str]) -> func.HttpResponse:
+    input_msg = req.params.get('name')
+    msg.set(input_msg)
+    logging.info(input_msg)
+    logging.info('name: {name}')
+    return 'OK'
+```
+
 ## Azure Service Bus queue trigger
 
 ```python
 import logging
 import azure.functions as func
 app = func.FunctionApp()
 @app.function_name(name="ServiceBusQueueTrigger1")
-@app.service_bus_queue_trigger(arg_name="msg", queue_name="myinputqueue", connection="")
+@app.service_bus_queue_trigger(arg_name="msg", queue_name="myinputqueue", connection="AzureWebJobsStorage")
 def test_function(msg: func.ServiceBusMessage):
     logging.info('Python ServiceBus queue trigger processed message: %s',
                  msg.get_body().decode('utf-8'))
@@ -138,13 +243,30 @@ import logging
 import azure.functions as func
 app = func.FunctionApp()
 @app.function_name(name="ServiceBusTopicTrigger1")
-@app.service_bus_topic_trigger(arg_name="message", topic_name="mytopic", connection="", subscription_name="testsub")
+@app.service_bus_topic_trigger(arg_name="message", topic_name="mytopic", connection="AzureWebJobsStorage", subscription_name="testsub")
 def test_function(message: func.ServiceBusMessage):
     message_body = message.get_body().decode("utf-8")
     logging.info("Python ServiceBus topic trigger processed message.")
     logging.info("Message Body: " + message_body)
 ```
 
+## Azure Service Bus Topic output binding
+
+```python
+import logging
+import azure.functions as func
+app = func.FunctionApp()
+@app.route(route="put_message")
+@app.service_bus_topic_output(
+    arg_name="message",
+    connection="AzureWebJobsStorage",
+    topic_name="mytopic")
+def main(req: func.HttpRequest, message: func.Out[str]) -> func.HttpResponse:
+    input_msg = req.params.get('message')
+    message.set(input_msg)
+    return 'OK'
+```
+
 ## Timer trigger
 
 ```python

articles/api-management/api-management-policy-expressions.md

@@ -412,7 +412,7 @@ At this time, only specific triggers and bindings are supported by the Python v2
 | [Azure Service Bus topic](functions-bindings-triggers-python.md#azure-service-bus-topic-trigger) | x |   | x |
 | [Azure Service Bus queue](functions-bindings-triggers-python.md#azure-service-bus-queue-trigger) | x |   | x |
 | [Azure Cosmos DB](functions-bindings-triggers-python.md#azure-eventhub-trigger) | x | x | x |
-| [Azure Blob Storage](functions-bindings-triggers-python.md#blob-trigger) | x | x | x |
+| [Azure Blob Storage](functions-bindings-triggers-python.md#azure-blob-storage-trigger) | x | x | x |
 | [Azure Hub](functions-bindings-triggers-python.md#azure-eventhub-trigger) | x |   | x |
 
 For more examples, see [Python V2 model Azure Functions triggers and bindings (preview)](functions-bindings-triggers-python.md).

articles/azure-functions/functions-bindings-triggers-python.md

@@ -56,6 +56,7 @@ Configure a table for Basic logs if:
     | [AMSKeyDeliveryRequests](/azure/azure-monitor/reference/tables/AMSKeyDeliveryRequests) | Azure Media Services HTTP request details for key, or license acquisition. |
     | [AMSMediaAccountHealth](/azure/azure-monitor/reference/tables/AMSMediaAccountHealth) | Azure Media Services account health status. |
     | [AMSStreamingEndpointRequests](/azure/azure-monitor/reference/tables/AMSStreamingEndpointRequests) | Azure Media Services information about requests to streaming endpoints. |
+    | [ASCDeviceEvents](/azure/azure-monitor/reference/tables/ASCDeviceEvents) | Azure Sphere devices operations, with information about event types, event categories, event classes, event descriptions etc. |
     | [ContainerAppConsoleLogs](/azure/azure-monitor/reference/tables/containerappconsoleLogs) | Azure Container Apps logs, generated within a Container Apps environment. |
     | [ContainerLogV2](/azure/azure-monitor/reference/tables/containerlogv2) | Used in [Container insights](../containers/container-insights-overview.md) and includes verbose text-based log records. |
     | [DevCenterDiagnosticLogs](/azure/azure-monitor/reference/tables/DevCenterDiagnosticLogs) | Dev Center resources data plane audit logs. For example, dev boxes and environment stop, start, delete. |

articles/azure-functions/functions-reference-python.md

@@ -95,6 +95,9 @@ A large training dataset is required to improve recognition. Generally, we recom
 
 Audio files can have silence at the beginning and end of the recording. If possible, include at least a half-second of silence before and after speech in each sample file. Although audio with low recording volume or disruptive background noise is not helpful, it shouldn't limit or degrade your custom model. Always consider upgrading your microphones and signal processing hardware before gathering audio samples.
 
+> [!IMPORTANT]
+> For more information about the best practices of preparing human-labeled transcripts, see [Human-labeled transcripts with audio](how-to-custom-speech-human-labeled-transcriptions.md). 
+
 Custom Speech projects require audio files with these properties:
 
 | Property                 | Value                               |

articles/azure-monitor/logs/basic-logs-configure.md

@@ -31,6 +31,9 @@ The table in this section summarizes the locales and voices supported for Speech
 
 Additional remarks for Speech-to-text locales are included in the [Custom Speech](#custom-speech) section below. 
 
+> [!TIP]
+> Try out the [Real-time Speech-to-text tool](https://speech.microsoft.com/portal/speechtotexttool) without having to use any code.
+
 [!INCLUDE [Language support include](includes/language-support/stt.md)]
 
 ### Custom Speech

articles/cognitive-services/Speech-Service/how-to-custom-speech-test-and-train.md

@@ -44,8 +44,8 @@ Azure Communications Gateway supports the Microsoft specifications for Certified
 
 The Microsoft Phone System relies on information in SIP signaling to determine whether a call is:
 
-- To a Teams Mobile Phone subscriber.
-- From a Teams Mobile Phone subscriber or between two Teams Phone Mobile subscribers.
+- To a Teams Phone Mobile subscriber.
+- From a Teams Phone Mobile subscriber or between two Teams Phone Mobile subscribers.
 
 Your core mobile network must supply this information to Azure Communications Gateway, by using unique trunks or by correctly populating an `X-MS-FMC` header as defined by the Teams Phone Mobile SIP specifications.